MOmonta
Team Members

Bulk invite team members

Changed on

Invite multiple users to the same team in a single request. Each member is processed independently — a failure on one item does not abort siblings. The response is a list with one entry per input member, in order, indicating individual outcomes.</br></br>Required scope: team-members:write </br>Organization authorization: supported

post/api/v1/team-members/bulk

Request

  • Base URL
    https://partner-api.monta.com
  • URL
    https://partner-api.monta.com/api/v1/team-members/bulk
  • Auth
    HTTP bearer

Request body

teamIdinteger

Id of the team that the members will be invited to. All members in the request are added to this team.

Example request

{
  "teamId": 1,
  "members": [
    {
      "userId": 1,
      "email": "partner-api@monta.com",
      "phone": "+45123456789",
      "priceGroupId": 1,
      "costGroupId": 1,
      "teamMemberProfileId": 1,
      "teamWalletChargePaymentType": "none",
      "canPayForChargesCountryIds": [
        1,
        2,
        3
      ],
      "note": "Welcome to the Monta team",
      "chargePointIds": [
        1,
        2,
        3,
        4
      ],
      "partnerExternalId": "ACME-12345",
      "partnerCustomPayload": {
        "internalId": "ACME-12345",
        "department": "Fleet"
      },
      "kwhPriceCapAc": 2.5,
      "kwhPriceCapDc": 5,
      "costCenterId": 1
    }
  ]
}

Response

Per-member invite results

indexinteger

Zero-based index of the member in the request members array this result corresponds to

status'created' | 'failed' required
errorstring nullable

Failure reason, present only when status is failed

Example response

[
  {
    "teamMember": {
      "id": 1,
      "teamId": 42,
      "displayName": "Casper Rasmussen",
      "operator": {
        "id": 14,
        "name": "Monta",
        "identifier": "monta",
        "partnerId": 1,
        "vatNumber": "FOO-123-ABC"
      },
      "partnerExternalTeamId": "A1B2C3BE3121",
      "userId": 1,
      "email": "example@monta.com",
      "phone": "+4512345678",
      "note": "A Note",
      "invitedAt": "2022-05-12T15:56:45.99Z",
      "invitedBy": "example@monta.com",
      "acceptedAt": "2022-05-12T15:56:45.99Z",
      "acceptedBy": "example@monta.com",
      "rejectedAt": "2022-05-12T15:56:45.99Z",
      "createdAt": "2022-05-12T15:56:45.99Z",
      "updatedAt": "2022-05-12T16:56:45.99Z",
      "deletedAt": "2022-05-12T16:56:45.99Z",
      "priceGroupId": 1,
      "costGroupId": 1,
      "costCenterId": 1,
      "teamMemberProfileId": 1,
      "canPayForChargesCountryIds": [
        1,
        2,
        3
      ],
      "teamWalletChargePaymentType": "none",
      "partnerExternalId": "ACME-12345",
      "partnerCustomPayload": {
        "internalId": "ACME-12345",
        "department": "Fleet"
      },
      "kwhPriceCapAc": 2.5,
      "kwhPriceCapDc": 5,
      "sponsoredPriceGroupId": 1
    }
  }
]

Changes

  • 0ca400461c52Revision changes
    • breaking

      the // request property type changed from array to object

    • breaking

      the // request property type changed from string to no type

    • breaking

      the ////// response's property type changed from array to object for status

    • warning

      removed subschema #2 from the // request property allOf list

    • warning

      added the new team_and_parent enum value to the ////// response property for the response status

    • info

      added the new optional request property //

    • info

      the request property default value changed from true to false

    • info

      added the new team_and_parent enum value to the request property //////

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added to the ////// response property allOf list for the response status

    • info

      added to the ////// response property allOf list for the response status

    • info

      removed from the ////// response property allOf list for the response status

    • info

      removed from the ////// response property allOf list for the response status