Result

Invites the member to Workable by sending them an email to the email address specified in the body of the request.

It is important to note that when inviting a new member using the parameter member_id (e.g. using account token), then that member must not be a reviewer or a member without access or else a 403 Forbidden error is expected.

It is also important to note that when inviting a new member, the following role combinations are not allowed and will result in a 422 Unprocessable Entity error:

No recruiting or superadmin role in roles array ifHRIS application is deactivated
No recruiting, no HR and no superadmin role in roles array - ifHRIS application is activated

Making requests to the POST /members/invite endpoint will invite the given member and return it. It will also send an email to invite the member to the email address specified in the request. An example of the response follows:

{
  "id": "3ff4d641",
  "email": "john.doe@workable.com",
  "roles": ["ats.simple", "hris.limited"],
  "collaboration_rules": []
}

Each member will have the following keys:

key	type	description
id	`string`	The member identifier
email	`string`	The email address of the member
roles	`string[]`	The member's roles in an array. Possible values are `ats.admin`, `ats.simple`, `ats.reviewer`, `hris.admin`, `hris.employee`, `hris.limited`, `workable.superadmin` plus any permission sets assigned to the member. You can find more info regarding permission sets here and the endpoint to get the permission sets currently created in the account here
collaboration_rules	`Array`	An array of the collaboration rules the member has. Each rule contains the role of the member in the collaboration, an array of departments and an array of locations that this collaborations is applicable for. More info here

If you try to create a member Workable API will response with 401 Unauthorized, 403 Forbidden and 422 Unprocessable Entity as error codes when an error occurs. Such errors can be mistakes in the authentication, trying to create a member with an email that already exists, mandatory fields missing, or make more invitations that your subscription plan allows.

201201

401401

403403

422422