Create a team membership | Documentation

curl -X POST https://api.contentful.com/organizations/4EJGvuLTBUMG2A6wS8gfAS/teams/2v0NGpymMx5dc1sWjtiarg/team_memberships \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "organizationMembershipId": "2J75WDB0QSfoBCn2IYTXzm"
}'

{
  "sys": {
    "type": "TeamMembership",
    "id": "5sjDwHAf1FRG65kPCwgzxc",
    "organization": {
      "sys": {
        "type": "Link",
        "linkType": "Organization",
        "id": "4EJGvuLTBUMG2A6wS8gfAS"
      }
    },
    "team": {
      "sys": {
        "type": "Link",
        "linkType": "Organization",
        "id": "OpTgoCqMTwTBUMG2A6w7Jg"
      }
    },
    "createdAt": "2025-08-29T05:29:02.000Z",
    "updatedAt": "2025-08-29T05:29:02.000Z",
    "organizationMembership": {
      "sys": {
        "type": "Link",
        "linkType": "OrganizationMembership",
        "id": "2J75WDB0QSfoBCn2IYTXzm"
      }
    },
    "user": {
      "sys": {
        "type": "Link",
        "linkType": "User",
        "id": "3sTeMpHKBy4Yycw6xmki6W"
      }
    }
  }
}

Creates a new team membership. Only organization admins and owners can manage team memberships.

Authentication

AuthorizationBearer

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

Path parameters

organization_idstringRequired

The organization ID

team_idstringRequired

The team ID

Request

This endpoint expects a map from strings to any.

Response

Created - Team membership created successfully