Create account link
Concise API reference for POST /api/integrations/link.
Endpoint
POST /api/integrations/link
Requires a Bearer API key, Content-Type: application/json, an Idempotency-Key, an active integration, and the Generate links capability. Maximum request size: 16 KB.
JSON body
| Name | Type | Required | Constraints |
|---|---|---|---|
uuid | string | Yes | 1–255 characters |
username | string | No | 1–50 characters when present |
email | string | No | Valid email, at most 320 characters |
destination | string | No | Internal Forum path only |
Success
Returns 201 with url and expiresAt. The opaque URL expires after 10 minutes. An identical idempotent replay returns the original operation rather than issuing multiple usable identities.
Endpoint errors
Common failures include invalid_request, invalid_destination, invalid_idempotency_key, unauthorized, integration_disabled, capability_disabled, idempotency_conflict, and payload_too_large. See Errors for status and retry guidance.