Skip to main content

Bulk invite up to 50 users

POST 

/users/bulk-invite

Invites up to 50 users in a single request. Each item is processed independently. Partial failures do not roll back successful items — check per-item status in the response. Errors for individual items are included in the results array, not as HTTP errors.

Request

Header Parameters

    Idempotency-Key string

    Optional idempotency key (24 h cache). Repeat calls with the same key and path return the cached response.

Body

required

    invites

    object[]

    required

    Possible values: >= 1, <= 50

    Up to 50 invite items per request.

  • Array [

  • emailemailrequired
    Example: bob@example.com
    namestringrequired

    Possible values: non-empty

    Example: Bob Jones
    rolestring
    Example: developer
    projectIdsuuid[]

    externalRef

    object

    providerstringrequired

    Possible values: non-empty

    externalTypestringrequired

    Possible values: non-empty

    externalIdstringrequired

    Possible values: non-empty

    metadata

    object

    property name*any
  • ]

  • sendInviteboolean

    Send invitation emails for all items. Default false for bulk.

    Example: false

OK

Schema

    results

    object[]

    required

  • Array [

  • emailemailrequired
    statusstringrequired

    Possible values: [invited, existing, linked, error]

    userIduuidnullablerequired
    inviteIduuidnullablerequired
    errorstring | nullnullablerequired
  • ]

  • successCountintegerrequired
    Example: 9
    failureCountintegerrequired
    Example: 1