Create a space membership | Documentation

curl -X POST https://api.contentful.com/spaces/jn066pnp3hgr/space_memberships \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "admin": false,
  "roles": [
    {
      "sys": {
        "type": "Link",
        "linkType": "Role",
        "id": "1ElgCn1mi1UHSBLTP2v4TD"
      }
    }
  ],
  "email": "user@example.com"
}'

{
  "admin": false,
  "sys": {
    "type": "SpaceMembership",
    "id": "jn066pnp3hgr-7uqvFPPLzgtVaezGvjA9U6",
    "version": 0,
    "createdAt": "2025-08-18T15:24:44Z",
    "updatedAt": "2025-08-18T15:24:44Z",
    "space": {
      "sys": {
        "type": "Link",
        "linkType": "Space",
        "id": "jn066pnp3hgr"
      }
    },
    "user": {
      "sys": {
        "type": "Link",
        "linkType": "User",
        "id": "7uqvFPPLzgtVaezGvjA9U6"
      }
    }
  },
  "roles": [
    {
      "sys": {
        "type": "Link",
        "linkType": "Role",
        "id": "1ElgCn1mi1UHSBLTP2v4TD"
      }
    }
  ]
}

Creates a space membership, assigning the user as admin or to one or more roles. The user must exist in the organization and is identified by their email address.

Authentication

AuthorizationBearer

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

Path parameters

space_idstringRequired

The space ID

Request

This endpoint expects a map from strings to any.

Response

Created - Space membership created successfully