Skip to content
campaiDeveloper
campai.com

Connect · Teams

POST/connect/organizations/{organizationId}/teams/{teamId}/memberships/manual

Add manual team memberships

Adds 1 to 100 unique contacts as manual members of a team. Existing roles are preserved, and manual memberships are protected from automatic synchronization. The endpoint returns no value.

Permissions

Send an API key of the organization in the path, using the X-API-Key header.

Who may call it

  • The caller must have organization access and the team.edit permission.
  • The caller must have mandate.read. The contact lookup also applies the caller's mandate restrictions.
  • Each contact must have at least one type the caller can read: contact:member.read for member, contact:address.read for address, contact:customer.read for customer, contact:sponsor.read for sponsor, contact:contributor.read for contributor, contact:employee.read for employee, or contact:supplier.read for supplier.

Request

Path parameters

  • organizationIdidrequired
  • teamIdidrequired

Body

Content-Type: application/json

  • contactIdsid[]required

    1–100 items

Request
curl --fail-with-body --silent --show-error --max-time 30 --globoff \
  --request POST 'https://cloud.campai.com/api/connect/organizations/YOUR_ORGANIZATION_ID/teams/YOUR_TEAM_ID/memberships/manual' \
  --header 'X-API-Key: YOUR_API_KEY'

No request that worked has been recorded yet, so the body is not shown.

Response

200 Successful response

No response body is specified.

What else happens

  • Existing team links are marked manual; contacts without a link receive a new manual link.
  • If the team has a parent, parent-team memberships are synchronized.
  • Team membership revisions and, when membership counts change, team counts are updated.
  • When a user loses access to an affected team and has no remaining membership, their chat activity state for that team is deleted.
  • The Connect user-organization cache is cleared for the affected contacts.

Errors

Other errors

StatusErrorWhen
404The team was not foundIf the team is not found in the organization, the request returns 404 with key routes.connect.teams.notFound.
404Some contacts were not found or you do not have access to themIf any requested contact is not found or is inaccessible, the request returns 404 with key routes.connect.teams.contactsNotFound.
404No fixed messageIf the team or its parent cannot be matched during the membership update, the request returns 404. No message key is specified.

Errors nearly every request can meet are listed under Errors.