Docs
Add Crew Via Users
POST /collaborators/{collaboratorId}/users
POST
/collaborators/{collaboratorId}/usersRequired Tokens
| Field | Type | Required | Description |
|---|---|---|---|
| Bearer | Authorization: Bearer <api-key> | Optional | Your API key. Pass it as the Bearer token on every request. |
Bulk-adds crew members to a collaborator by looking up existing user accounts by email. Each email is resolved to a user; if found, a linked crew record is created automatically. Any emails that fail (user not found, already added, etc.) are reported in the response rather than causing the whole request to fail.
Path Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| collaboratorId | Guid | Required | The ID of the collaborator to add crew to. |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| emails | string[] | Required | List of user email addresses to look up and add as crew. |
Response
Returns 201 Created. The body reports any emails that could not be processed.
| Field | Type | Description |
|---|---|---|
| failedCrewAdds | Failure[] | Emails that failed to be added as crew. Empty array if all succeeded. |
| failedCrewAdds[].email | string | The email that failed. |
| failedCrewAdds[].errorMessage | string | Reason for the failure. |