solarOSsolarOS Docs

Create or resolve a draft Team Member

Creates a same-organization draft Team Member for external integrations, or returns an existing member matched by Salesforce identity, email, or External Reference. Draft Team Members have no Clerk id and can own imported records without granting sign-in access. Requires Idempotency-Key and team_members:write.

POST
/team-members

Creates a same-organization draft Team Member for external integrations, or returns an existing member matched by Salesforce identity, email, or External Reference. Draft Team Members have no Clerk id and can own imported records without granting sign-in access. Requires Idempotency-Key and team_members:write.

Authorization

Authorization<token>

Organization API key. Format: Bearer sk_live_...

In: header

Request Body

application/json

JSON request payload for createTeamMember.

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/team-members" \  -H "Content-Type: application/json" \  -d '{    "email": "technician@example.com",    "firstName": "Grace",    "lastName": "Hopper",    "role": "TECHNICIAN",    "status": "DRAFT"  }'
{  "data": {    "id": "string",    "email": "user@example.com",    "firstName": "string",    "lastName": "string",    "displayName": "string",    "role": "string",    "isActive": true,    "schedulable": true,    "status": "ACTIVE",    "phone": "string",    "salesforceUserId": "string",    "salesforceServiceResourceId": "string",    "createdAt": "2019-08-24T14:15:22Z",    "updatedAt": "2019-08-24T14:15:22Z"  },  "meta": {    "requestId": "string",    "version": "v1",    "timestamp": "2019-08-24T14:15:22Z",    "rateLimit": {      "limit": 0,      "remaining": 0,      "reset": 0    }  }}