Skip to content
Docs

Email invitations, invite codes and invite links.

Base URLhttps://api.socialit.com/v1AuthenticationErrorsRate limits1 endpointsMCP toolset team

Create an invite link

POST/invite/tokens

A shareable link that adds whoever opens it (after sign-in) to this workspace with the given role and profile access.

Access: adminIdempotency-KeyZernio: POST /v1/invite/tokens

Try it with MCPAsk your agent to call create-invite-token (toolset team)Set up MCP

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Body object

rolestringdefault: "member"

adminmemberbillingviewer

profile_idsarray of string

≤ 500 items

scopestring

Zernio compatibility: profiles requires profile_ids

allprofiles

expires_inintegerdefault: 604800

Seconds until the link expires (default 7 days, max 30)

300–2592000

Returns object

objectstring

invite_token

tokenstring
urlstring
rolestring

adminmemberbillingviewer

profile_idsarray of string
expires_atstring (date-time) | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/invite/tokens
curl -X POST "https://api.socialit.com/v1/invite/tokens" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "role": "member",
    "profile_ids": [
      "string"
    ],
    "scope": "all",
    "expires_in": 604800
  }'
Response · 201
{
  "object": "invite_token",
  "token": "string",
  "url": "https://example.com",
  "role": "admin",
  "profile_ids": [
    "string"
  ],
  "expires_at": "2026-10-13T09:00:00.000Z"
}