Creates a Membership

Assign an employee to a team, meaning create a membership. For companies with nested teams, two extra semantics apply. Propagation: memberships are inherited upwards, so after adding an employee to a sub-team, inherited membership rows for its ancestor teams are materialized asynchronously — rows you did not create will appear in later reads. Reuse: if the employee already has a membership row on that team (typically an inherited one), no new row is created — the employee becomes a direct member of the team and the existing row (with its existing id) is returned instead of a new resource. On a reused row, lead: true promotes the employee, while lead: false or omitting lead leaves their leadership as it was: an addition never demotes a current lead, so use the update endpoint to demote. A genuinely new row is created with the lead you send, or without it. The response is still 201 when an existing row is reused, so compare the returned id against what you already hold to tell the two cases apart.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

Team id.

string
required

Employee id.

boolean

Makes the employee a lead of the team. Omit it to leave an existing row's flag untouched; a new row is created without leadership.

Responses

Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json