Create an invitation | Documentation

curl -X POST https://api.contentful.com/organizations/4EJGvuLTBUMG2A6wS8gfAS/invitations \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "email": "user@example.com",
  "firstName": "John",
  "lastName": "Doe",
  "role": "member"
}'

{
  "sys": {
    "id": "aasfdsgfesagrwg32ggs",
    "type": "Invitation",
    "status": "open",
    "organizationMembership": {
      "sys": {
        "type": "Link",
        "linkType": "OrganizationMembership",
        "id": "65jhgf45jrt8j945j89gt"
      }
    },
    "createdAt": "2025-10-10T21:34:49.000Z",
    "updatedAt": "2025-10-10T21:34:49.000Z",
    "createdBy": {
      "sys": {
        "type": "Link",
        "linkType": "User",
        "id": "dsf4tgfd43gf4t3g4"
      }
    },
    "user": null,
    "invitationUrl": "https://be.contentful.com/invitations/aasfdsgfesagrwg32ggs?token=xyzpdq"
  }
}

Invites a user to the organization. Only admins and owners can send invitations; this endpoint is in alpha and may introduce breaking changes.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

organization_idstringRequired

The organization ID

Request

This endpoint expects a map from strings to any.

Response

Created - Invitation created successfully