Feeling bold?
Sentry's Docs BotAsk A Bot
Product
API
Changelog
Sandbox
Sign In

Add a Member to an Organization

POST /api/0/organizations/{organization_slug}/members/

Add or invite a member to an organization.

Path Parameters

organization_slug (string)
REQUIRED

The slug of the organization the resource belongs to.

Body Parameters

email (string)
REQUIRED

The email address to send the invitation to.

orgRole (string)

The organization-level role of the new member. Roles include:

  • billing - Can manage payment and compliance details.
  • member - Can view and act on events, as well as view most other data within the organization.
  • manager - Has full management access to all teams and projects. Can also manage the organization's membership.
  • owner - Has unrestricted access to the organization, its data, and its settings. Can add, modify, and delete projects and members, as well as make billing and plan changes.
  • admin - Can edit global integrations, manage projects, and add/remove teams. They automatically assume the Team Admin role for teams they join. Note: This role can no longer be assigned in Business and Enterprise plans. Use TeamRoles instead.
teamRoles (array(object))

The team and team-roles assigned to the member. Team roles can be either:

  • contributor - Can view and act on issues. Depending on organization settings, they can also add team members.
  • admin - Has full management access to their team's membership and projects.
sendInvite (boolean)

Whether or not to send an invite notification through email. Defaults to True.

reinvite (boolean)

Whether or not to re-invite a user who has already been invited to the organization. Defaults to True.

Scopes

<auth_token> requires one of the following scopes:
  • member:admin
  • member:write
curl https://sentry.io/api/0/organizations/{organization_slug}/members/ \
 -H 'Authorization: Bearer <auth_token>' \
 -H 'Content-Type: application/json' \
 -d '{}'
RESPONSESCHEMA
{
  "id": "57377908164",
  "email": "sirpenguin@antarcticarocks.com",
  "name": "Sir Penguin",
  "user": {
    "id": "280094367316",
    "name": "Sir Penguin",
    "username": "sirpenguin@antarcticarocks.com",
    "email": "sirpenguin@antarcticarocks.com",
    "avatarUrl": "https://secure.gravatar.com/avatar/16aeb26c5fdba335c7078e9e9ddb5149?s=32&d=mm",
    "isActive": true,
    "hasPasswordAuth": true,
    "isManaged": false,
    "dateJoined": "2021-07-06T21:13:58.375239Z",
    "lastLogin": "2021-08-02T18:25:00.051182Z",
    "has2fa": false,
    "lastActive": "2021-08-02T21:32:18.836829Z",
    "isSuperuser": false,
    "isStaff": false,
    "experiments": {},
    "emails": [
      {
        "id": "2153450836",
        "email": "sirpenguin@antarcticarocks.com",
        "is_verified": true
      }
    ],
    "avatar": {
      "avatarType": "letter_avatar",
      "avatarUuid": null
    },
    "authenticators": [],
    "canReset2fa": true
  },
  "role": "member",
  "orgRole": "member",
  "roleName": "Member",
  "pending": false,
  "expired": false,
  "flags": {
    "idp:provisioned": false,
    "idp:role-restricted": false,
    "sso:linked": false,
    "sso:invalid": false,
    "member-limit:restricted": false,
    "partnership:restricted": false
  },
  "dateCreated": "2021-07-06T21:13:01.120263Z",
  "inviteStatus": "approved",
  "inviterName": "maininviter@antarcticarocks.com"
}