Partner API
Invite a team member
POST /api/v2/users/invites - Creates a pending invite and sends the invite email when possible.
POST
/api/v2/users/invitesCreates a pending invite and sends the invite email when possible.
Required scope: users (or *).
JSON body
| Name | Required | Description |
|---|---|---|
email | Yes | Invitee email |
role | No | admin or agent (default agent) |
first_name | No | Invitee first name |
last_name | No | Invitee last name |
phone | No | Invitee phone |
curl -s -X POST -H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"email": "new.agent@example.com",
"role": "agent",
"first_name": "Sam",
"last_name": "Lee",
"phone": "5551112222"
}' \
"https://benefitpath.com/api/v2/users/invites"
{
"success": true,
"invite": {
"email": "new.agent@example.com",
"role": "agent",
"first_name": "Sam",
"last_name": "Lee"
}
}
See Errors for the standard error envelope and rate limits.