Teams > Membership > Deletes

webhook

Webhooks > Teams > Membership > Deletes

Subscription_type: teams/membership/delete. Triggered when a membership is deleted through this verb, whether the deletion is made through the API or from Factorial. The payload is the row the request named, which may itself be an inherited one. The direct rows removed in its source sub-teams as a consequence, and the inherited copies cleaned up afterwards in ancestor teams, do not trigger this event; read the memberships endpoint if you need to track them. Nor is this a complete feed of removals: for companies with nested teams, removing members in bulk and setting the complete set of teams an employee belongs to — which is also how imports write there — emit nothing at all, so those removals are only observable by reading that endpoint too.

Payload

Callback payload

string

required

Membership ID

company_id

string

Company ID of the membership

employee_id

string

required

Employee ID of the membership

team_id

string

required

Team ID of the membership

lead

boolean

required

Whether the employee is a lead of the team or not

source_team_ids

array of strings

required

IDs of the teams this membership originates from (nested teams). In a company with nested teams, a direct membership includes the team itself; an inherited one, the sub-team(s) where the employee is a direct member. Only populated on reads that compute source attribution — reads filtered by a single team, or by a single employee with with_source_attribution enabled. Empty otherwise, including create, update and delete responses, and always empty for companies without nested teams. An empty array does not distinguish "computed and genuinely empty" from "not computed for this read" or "could not be computed", so only apply attribution-dependent logic to a read you explicitly shaped for it. A team-anchored read stops attributing above roughly a thousand members of the filtered team: past that the attribution is not computed at all and every row comes back empty, behind a normal 200.

source_team_ids*

parent_team_ids

array of strings

required

IDs of the ancestor teams that receive an inherited membership through this row (nested teams) — the teams this membership rolls up into. Populated under the same conditions as source_team_ids; empty otherwise.

parent_team_ids*

direct

boolean

Whether the employee is a direct member of the team (nested teams). Always present. true means direct member; false means the row exists only through inheritance from a sub-team; null means not computed for this read. Only computed on reads filtered by a single employee with with_source_attribution enabled — always null otherwise, including create, update and delete responses and companies without nested teams. null is also returned when directness could not be resolved for a transient reason, even with with_source_attribution enabled, so never treat null as false — retry the read instead.

Response

200

Return a 200 status to indicate that the data was received successfully