Team Members

Retrieve a list of team members.

GET

https://partner-api.monta.com

/api/v1/team-members

Required scope: team-members:read
Organization authorization: supported

Retrieve a list of team members. › query Parameters

page

integer · int32

page number to retrieve (starts with 0)

Default: 0

perPage

integer · int32

number of items per page (between 1 and 100, default 10)

Default: 10

teamId

integer | null · int64

Filter team members by teamId

Example: 1

includeDeleted

boolean

Includes deleted resources in the response

Example: true

Default: false

role

string · enum

Filter team members by the specified role

Enum values:

admin

user

other

Example: admin

state

string · enum

Filter team members by the specified state

Enum values:

requested

invited

rejected

accepted

blocked

expired

other

Example: expired

userId

integer | null · int64

Filter team members with specified userId

Example: 42

email

string | null · email

Filter team members with specified email

Example: user@acme.com

phone

string | null · pattern: ^\+[1-9]\d{1,14}$

Filter team members with specified phone number

Example: +451234567

partnerExternalTeamId

string | null

Filter team members by the specified partnerExternalTeamIdNote: partnerExternalTeamId refers to external id on the team level

Example: 1A2B3C4D5E

partnerExternalId

string | null

Filter team members with specified partnerExternalId

Example: 1A2B3C4D5E

Retrieve a list of team members. › Responses

List of team members that match the criteria

OffsetBasedResponse_61

TeamMember[] · required

MontaPage.Meta · required

GET/api/v1/team-members

curl https://partner-api.monta.com/api/v1/team-members \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "data": [
    {
      "id": 1,
      "teamId": 42,
      "displayName": "Casper Rasmussen",
      "operator": {
        "id": 14,
        "name": "Monta",
        "identifier": "monta",
        "partnerId": 1,
        "vatNumber": "FOO-123-ABC"
      },
      "partnerExternalTeamId": "A1B2C3BE3121",
      "teamType": "private",
      "userId": 1,
      "email": "example@monta.com",
      "phone": "+4512345678",
      "role": "admin",
      "access": "all",
      "state": "accepted",
      "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",
      "chargePointIds": [
        0
      ],
      "priceGroupId": 1,
      "costGroupId": 1,
      "costCenterId": 1,
      "teamMemberProfileId": 1,
      "canConfigureChargePoints": false,
      "canPayWithTeamWallet": false,
      "canManageTeamWallet": false,
      "canDepositToWallet": true,
      "canWithdrawFromWallet": true,
      "canManageChargeKeys": true,
      "canRequestSponsoring": false,
      "canManageTeamMembers": false,
      "canPayForChargesCountryIds": [
        1,
        2,
        3
      ],
      "teamWalletChargePaymentType": "none",
      "partnerExternalId": "ACME-12345",
      "partnerCustomPayload": {
        "internalId": "ACME-12345",
        "department": "Fleet"
      },
      "kwhPriceCapAc": 2.5,
      "kwhPriceCapDc": 5,
      "sponsoredPriceGroupId": 1,
      "autoApproveElectricityCost": false,
      "reimbursementEnabled": false,
      "reimbursementPayoutSchedule": "end-of-month",
      "reimbursementSubscription": false
    }
  ],
  "meta": {
    "itemCount": 0,
    "currentPage": 0,
    "perPage": 0,
    "totalPageCount": 0,
    "totalItemCount": 0
  }
}

json

application/json

Create (invite) a team member

POST

https://partner-api.monta.com

/api/v1/team-members

Create (invite) a user to join a team, invitation can be done via userId, email and/or phone. A user that does not exist in yet will have a null userId.

Required scope: team-members:write
Organization authorization: supported

Create (invite) a team member › Request Body

CreateTeamMember

role

string · enum · required

Role for this member within the team

Enum values:

admin

user

other

Example: admin

teamId

integer · int64

Id of the team that the user will be invited

Example: 1

userId

integer | null · int64

Id of the user to be invited
Note: When inviting by userId the fields email or phone must not be provided.

Example: 1

email

string | null · email

Email of the user to be invited
Note: When inviting by email the fields userId or phone must not be provided.

Example: partner-api@monta.com

phone

string | null · pattern: ^\+[1-9]\d{1,14}$

Phone of the user to be invited
Note: When inviting by phone the fields userId or email must not be provided.

Example: +45123456789

priceGroupId

integer | null · int64

The price group for this team member, when not provided the default team price group will be applied

Example: 1

costGroupId

integer | null · int64

The cost group for this team member

Example: 1

teamMemberProfileId

integer | null · int64

The team member profile id to apply to this team member

Example: 1

canConfigureChargePoints

boolean

Indicates if the team member can configure charge points

Example: false

Default: false

canPayWithTeamWallet

boolean

Gives the team member access to pay with the team wallet in the Monta shop (e.g. charge keys, stickers). Team wallet payment for charging sessions is controlled by teamWalletChargePaymentType

Example: false

Default: false

canRequestSponsoring

boolean

Allows the team member to request sponsoring from this team for their charge point

Example: false

Default: false

canManageTeamMembers

boolean

Allows the team member to view and manage other members settings

Example: false

Default: false

teamWalletChargePaymentType

string · enum

On which chargers is the team member allowed to pay with Team Wallet?

* all - On any charger (including roaming chargers)
* partner - On chargers with the same partner as this team
* operator - On chargers with the same operator as this team
* team - On chargers belonging to this team
* team_and_parent - Own and parent account's chargers; no public or roaming
* selected_operators - On chargers from selected operators
* none - The team member is not allowed to pay with Team Wallet for any charge session

Enum values:

partner

operator

all

team

team_and_parent

selected_operators

none

Example: none

Default: none

canDepositToWallet

boolean | null

Gives the team member permission to deposit to the team wallet

canWithdrawFromWallet

boolean | null

Gives the team member permission to withdraw from the team wallet

canManageChargeKeys

boolean | null

Gives the team member permission to manage charge keys for the team

canPayForChargesCountryIds

array | null

List of country ids for which the team member can pay for charges

Example: [1,2,3]

note

string | null

A note for the team member

Example: Welcome to the Monta team

chargePointIds

array | null

Ids of the charge point this team member with will have access

Example: [1,2,3,4]

partnerExternalId

string | null

External Id of this entity, managed by you.

Example: ACME-12345

object | null

Custom JSON payload for this entity, managed by you.
Note: the expected shape is a flat JSON object with named keys. The payload is limited to 1000 characters.

Example: {"internalId":"ACME-12345","department":"Fleet"}

notifyUser

boolean

Controls whether an invitation email and/or SMS is sent to the user based on the provided email and phone fields.

Example: true

Default: true

immediateAccess

boolean | null

Grants the invited member access to the team immediately, without waiting for them to accept the invitation. When true and the user already exists, the team member is created in accepted state so the operator can configure pricing, charge-point access and other settings right away. When true and the user does not yet exist, the immediate-access intent is persisted on the invitation and applied when the user registers — the team member is then created in accepted state with the inviter recorded as the acceptor (operator-initiated acceptance). If both immediateAccess and the deprecated autoAccept are sent, immediateAccess takes precedence.

Example: true

Default: false

kwhPriceCapAc

number | null

Maximum price per kWh in the team currency that the team will cover when charging on AC.

Example: 2.5

kwhPriceCapDc

number | null

Maximum price per kWh in the team currency that the team will cover when charging on DC.

Example: 5

sponsoredPriceGroupId

integer | null · int64

Price group used to reimburse this team member for home charging. Omit or set null to use the employee's own cost price group (cloned at SCP creation time).

Example: 1

autoApproveElectricityCost

boolean

When true, employee-submitted electricity costs are auto-approved for SCPs created for this team member.

Example: false

Default: false

reimbursementEnabled

boolean

Master switch — whether the team member participates in home reimbursement.

Example: false

Default: false

reimbursementPayoutSchedule

string · enum

Default payout schedule applied to sponsored charge points created for this team member.

Enum values:

end-of-month

realtime

other

Example: end-of-month

reimbursementSubscription

boolean

Whether the operator reimburses the charge-point subscription price.

Example: false

Default: false

costCenterId

integer | null · int64

The cost center to assign to this team member. Must belong to the same operator, and when it is scoped to a team, to that team.

Example: 1

Create (invite) a team member › Responses

Team member created

TeamMember

id

integer · int64 · required

Id of the team member

Example: 1

role

string · enum · required

Role of the this member within the team

Enum values:

admin

user

other

Example: admin

access

string · enum · required

Indicates if the user has access to all charge points or only to selected charge points

Enum values:

all

selected

other

Example: all

state

string · enum · required

State of the invitation

Enum values:

requested

invited

rejected

accepted

blocked

expired

other

Example: accepted

chargePointIds

integer[] · required

The charge points ids this team member has access

canPayForChargesCountryIds

integer[] · required

List of country ids for which the team member can pay for charges

Example: [1,2,3]

teamWalletChargePaymentType

TeamWalletChargePaymentType · enum · required

Enum values:

partner

operator

all

team

team_and_parent

selected_operators

none

Example: none

Default: none

teamId

integer · int64

Team id of team member

Example: 42

displayName

string | null

The team member display name, formats can be: First and Last Name, User: #id, email, or phone

Example: Casper Rasmussen

object

Operator of this team member

partnerExternalTeamId

string | null

The partner external id for the team

Example: A1B2C3BE3121

teamType

string · enum

Type of the team this member belongs to

Enum values:

personal

private

professional

operator

Example: private

userId

integer | null · int64

User id of team member. If the user does not exist yet, it will be null

Example: 1

email

string | null

Email of the team member

Example: example@monta.com

phone

string | null

Phone number of the team member

Example: +4512345678

note

string | null

Note for team member

Example: A Note

invitedAt

string | null · date-time

Date of team member was invited to join the team

Example: 2022-05-12T15:56:45.99Z

invitedBy

string | null

Email of the team member that invited this team member

Example: example@monta.com

acceptedAt

string | null · date-time

Date of team member accepted the invitation

Example: 2022-05-12T15:56:45.99Z

acceptedBy

string | null

Email of the team member that accepted the invitation

Example: example@monta.com

rejectedAt

string | null · date-time

Date of team member rejected the invitation

Example: 2022-05-12T15:56:45.99Z

createdAt

string | null · date-time

Date the team member was created

Example: 2022-05-12T15:56:45.99Z

updatedAt

string | null · date-time

Date the team member was updated

Example: 2022-05-12T16:56:45.99Z

deletedAt

string | null · date-time

Date the team member was deleted

Example: 2022-05-12T16:56:45.99Z

priceGroupId

integer | null · int64

The price group for this team member

Example: 1

costGroupId

integer | null · int64

The cost group for this team member

Example: 1

costCenterId

integer | null · int64

The cost center assigned to this team member. null when none is assigned, and always null while the invitation is still pending.

Example: 1

teamMemberProfileId

integer | null · int64

The team member profile id to apply to this team member

Example: 1

canConfigureChargePoints

boolean

Indicates if the team member can configure charge points

Example: false

Default: false

canPayWithTeamWallet

boolean

Indicates if the team member can pay with the team wallet in the Monta shop (e.g. charge keys, stickers). Team wallet payment for charging sessions is controlled by teamWalletChargePaymentType

Example: false

Default: false

canManageTeamWallet

boolean

Indicates if team member has access to withdraw and deposit from your team wallet to your bank account

Example: false

Default: false

canDepositToWallet

boolean | null

Indicates if team member can deposit to team wallet

canWithdrawFromWallet

boolean | null

Indicates if team member can withdraw from team wallet

canManageChargeKeys

boolean | null

Indicates if team member can manage charge keys for the team

canRequestSponsoring

boolean

Indicates if the team member is allowed to request sponsoring from this team for their charge point

Example: false

Default: false

canManageTeamMembers

boolean

Indicates that the team member can view and manage other members settings

Example: false

Default: false

partnerExternalId

string | null

External Id of this entity, managed by you

Example: ACME-12345

object | null

Custom JSON payload for this entity, managed by you.
Note: the expected shape is a flat JSON object with named keys.

Example: {"internalId":"ACME-12345","department":"Fleet"}

kwhPriceCapAc

number | null

Maximum price per kWh in the team currency that the team will cover when charging on AC.

Example: 2.5

kwhPriceCapDc

number | null

Maximum price per kWh in the team currency that the team will cover when charging on DC.

Example: 5

sponsoredPriceGroupId

integer | null · int64

Price group used to reimburse this team member for home charging. null means the employee's own cost price group is cloned at SCP creation time.

Example: 1

autoApproveElectricityCost

boolean

When true, employee-submitted electricity costs are auto-approved for SCPs created for this team member.

Example: false

Default: false

reimbursementEnabled

boolean

Master switch — whether the team member participates in home reimbursement. Gates auto-creation of sponsored charge points on acceptance and on charge-point install.

Example: false

Default: false

reimbursementPayoutSchedule

string · enum

Default payout schedule applied to sponsored charge points created for this team member.

Enum values:

end-of-month

realtime

other

Example: end-of-month

reimbursementSubscription

boolean

Whether the operator reimburses the charge-point subscription price for this team member.

Example: false

Default: false

POST/api/v1/team-members

curl https://partner-api.monta.com/api/v1/team-members \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "teamId": 1,
  "userId": 1,
  "email": "partner-api@monta.com",
  "phone": "+45123456789",
  "role": "admin",
  "priceGroupId": 1,
  "costGroupId": 1,
  "teamMemberProfileId": 1,
  "canConfigureChargePoints": false,
  "canPayWithTeamWallet": false,
  "canRequestSponsoring": false,
  "canManageTeamMembers": false,
  "teamWalletChargePaymentType": "none",
  "canManageTeamWallet": false,
  "canDepositToWallet": true,
  "canWithdrawFromWallet": true,
  "canManageChargeKeys": true,
  "canPayForChargesCountryIds": [
    1,
    2,
    3
  ],
  "note": "Welcome to the Monta team",
  "chargePointIds": [
    1,
    2,
    3,
    4
  ],
  "partnerExternalId": "ACME-12345",
  "partnerCustomPayload": {
    "internalId": "ACME-12345",
    "department": "Fleet"
  },
  "notifyUser": true,
  "autoAccept": false,
  "immediateAccess": false,
  "kwhPriceCapAc": 2.5,
  "kwhPriceCapDc": 5,
  "sponsoredPriceGroupId": 1,
  "autoApproveElectricityCost": false,
  "reimbursementEnabled": false,
  "reimbursementPayoutSchedule": "end-of-month",
  "reimbursementSubscription": false,
  "costCenterId": 1
}'

Example Request Body

{
  "teamId": 1,
  "userId": 1,
  "email": "partner-api@monta.com",
  "phone": "+45123456789",
  "role": "admin",
  "priceGroupId": 1,
  "costGroupId": 1,
  "teamMemberProfileId": 1,
  "canConfigureChargePoints": false,
  "canPayWithTeamWallet": false,
  "canRequestSponsoring": false,
  "canManageTeamMembers": false,
  "teamWalletChargePaymentType": "none",
  "canManageTeamWallet": false,
  "canDepositToWallet": true,
  "canWithdrawFromWallet": true,
  "canManageChargeKeys": true,
  "canPayForChargesCountryIds": [
    1,
    2,
    3
  ],
  "note": "Welcome to the Monta team",
  "chargePointIds": [
    1,
    2,
    3,
    4
  ],
  "partnerExternalId": "ACME-12345",
  "partnerCustomPayload": {
    "internalId": "ACME-12345",
    "department": "Fleet"
  },
  "notifyUser": true,
  "autoAccept": false,
  "immediateAccess": false,
  "kwhPriceCapAc": 2.5,
  "kwhPriceCapDc": 5,
  "sponsoredPriceGroupId": 1,
  "autoApproveElectricityCost": false,
  "reimbursementEnabled": false,
  "reimbursementPayoutSchedule": "end-of-month",
  "reimbursementSubscription": false,
  "costCenterId": 1
}

json

Example Responses

{
  "id": 1,
  "teamId": 42,
  "displayName": "Casper Rasmussen",
  "operator": {
    "id": 14,
    "name": "Monta",
    "identifier": "monta",
    "partnerId": 1,
    "vatNumber": "FOO-123-ABC"
  },
  "partnerExternalTeamId": "A1B2C3BE3121",
  "teamType": "private",
  "userId": 1,
  "email": "example@monta.com",
  "phone": "+4512345678",
  "role": "admin",
  "access": "all",
  "state": "accepted",
  "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",
  "chargePointIds": [
    0
  ],
  "priceGroupId": 1,
  "costGroupId": 1,
  "costCenterId": 1,
  "teamMemberProfileId": 1,
  "canConfigureChargePoints": false,
  "canPayWithTeamWallet": false,
  "canManageTeamWallet": false,
  "canDepositToWallet": true,
  "canWithdrawFromWallet": true,
  "canManageChargeKeys": true,
  "canRequestSponsoring": false,
  "canManageTeamMembers": false,
  "canPayForChargesCountryIds": [
    1,
    2,
    3
  ],
  "teamWalletChargePaymentType": "none",
  "partnerExternalId": "ACME-12345",
  "partnerCustomPayload": {
    "internalId": "ACME-12345",
    "department": "Fleet"
  },
  "kwhPriceCapAc": 2.5,
  "kwhPriceCapDc": 5,
  "sponsoredPriceGroupId": 1,
  "autoApproveElectricityCost": false,
  "reimbursementEnabled": false,
  "reimbursementPayoutSchedule": "end-of-month",
  "reimbursementSubscription": false
}

json

application/json

Bulk invite team members

POST

https://partner-api.monta.com

/api/v1/team-members/bulk

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.

Required scope: team-members:write
Organization authorization: supported

Bulk invite team members › Request Body

BulkInviteTeamMember

BulkInviteTeamMemberItem[] · minItems: 1 · maxItems: 50 · required

Members to invite to the team. Each item is processed independently — a failure on one member does not abort siblings. The response lists every input item with its individual outcome.

teamId

integer · int64

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

Example: 1

Bulk invite team members › Responses

Per-member invite results

BulkInviteTeamMemberResult[]

BulkInviteTeamMemberResult

status

string · enum · required

Outcome of the invite attempt for this member

Enum values:

created

failed

Example: created

index

integer · int32

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

object

Created team member, present only when status is created

error

string | null

Failure reason, present only when status is failed

POST/api/v1/team-members/bulk

curl https://partner-api.monta.com/api/v1/team-members/bulk \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "teamId": 1,
  "members": [
    {
      "userId": 1,
      "email": "partner-api@monta.com",
      "phone": "+45123456789",
      "role": "admin",
      "priceGroupId": 1,
      "costGroupId": 1,
      "teamMemberProfileId": 1,
      "canConfigureChargePoints": false,
      "canPayWithTeamWallet": false,
      "canRequestSponsoring": false,
      "canManageTeamMembers": false,
      "teamWalletChargePaymentType": "none",
      "canDepositToWallet": true,
      "canWithdrawFromWallet": true,
      "canManageChargeKeys": true,
      "canPayForChargesCountryIds": [
        1,
        2,
        3
      ],
      "note": "Welcome to the Monta team",
      "chargePointIds": [
        1,
        2,
        3,
        4
      ],
      "partnerExternalId": "ACME-12345",
      "partnerCustomPayload": {
        "internalId": "ACME-12345",
        "department": "Fleet"
      },
      "notifyUser": true,
      "immediateAccess": false,
      "kwhPriceCapAc": 2.5,
      "kwhPriceCapDc": 5,
      "costCenterId": 1
    }
  ]
}'

Example Request Body

{
  "teamId": 1,
  "members": [
    {
      "userId": 1,
      "email": "partner-api@monta.com",
      "phone": "+45123456789",
      "role": "admin",
      "priceGroupId": 1,
      "costGroupId": 1,
      "teamMemberProfileId": 1,
      "canConfigureChargePoints": false,
      "canPayWithTeamWallet": false,
      "canRequestSponsoring": false,
      "canManageTeamMembers": false,
      "teamWalletChargePaymentType": "none",
      "canDepositToWallet": true,
      "canWithdrawFromWallet": true,
      "canManageChargeKeys": true,
      "canPayForChargesCountryIds": [
        1,
        2,
        3
      ],
      "note": "Welcome to the Monta team",
      "chargePointIds": [
        1,
        2,
        3,
        4
      ],
      "partnerExternalId": "ACME-12345",
      "partnerCustomPayload": {
        "internalId": "ACME-12345",
        "department": "Fleet"
      },
      "notifyUser": true,
      "immediateAccess": false,
      "kwhPriceCapAc": 2.5,
      "kwhPriceCapDc": 5,
      "costCenterId": 1
    }
  ]
}

json

Example Responses

[
  {
    "index": 0,
    "status": "created",
    "teamMember": {
      "id": 1,
      "teamId": 42,
      "displayName": "Casper Rasmussen",
      "operator": {
        "id": 14,
        "name": "Monta",
        "identifier": "monta",
        "partnerId": 1,
        "vatNumber": "FOO-123-ABC"
      },
      "partnerExternalTeamId": "A1B2C3BE3121",
      "teamType": "private",
      "userId": 1,
      "email": "example@monta.com",
      "phone": "+4512345678",
      "role": "admin",
      "access": "all",
      "state": "accepted",
      "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",
      "chargePointIds": [
        0
      ],
      "priceGroupId": 1,
      "costGroupId": 1,
      "costCenterId": 1,
      "teamMemberProfileId": 1,
      "canConfigureChargePoints": false,
      "canPayWithTeamWallet": false,
      "canManageTeamWallet": false,
      "canDepositToWallet": true,
      "canWithdrawFromWallet": true,
      "canManageChargeKeys": true,
      "canRequestSponsoring": false,
      "canManageTeamMembers": false,
      "canPayForChargesCountryIds": [
        1,
        2,
        3
      ],
      "teamWalletChargePaymentType": "none",
      "partnerExternalId": "ACME-12345",
      "partnerCustomPayload": {
        "internalId": "ACME-12345",
        "department": "Fleet"
      },
      "kwhPriceCapAc": 2.5,
      "kwhPriceCapDc": 5,
      "sponsoredPriceGroupId": 1,
      "autoApproveElectricityCost": false,
      "reimbursementEnabled": false,
      "reimbursementPayoutSchedule": "end-of-month",
      "reimbursementSubscription": false
    },
    "error": "error"
  }
]

json

application/json

Retrieve a team member.

GET

https://partner-api.monta.com

/api/v1/team-members/{id}

Required scope: team-members:read
Organization authorization: supported

Retrieve a team member. › path Parameters

id

integer · int64 · required

Retrieve a team member. › Responses

Team member with provided id

TeamMember

id

integer · int64 · required

Id of the team member

Example: 1

role

string · enum · required

Role of the this member within the team

Enum values:

admin

user

other

Example: admin

access

string · enum · required

Indicates if the user has access to all charge points or only to selected charge points

Enum values:

all

selected

other

Example: all

state

string · enum · required

State of the invitation

Enum values:

requested

invited

rejected

accepted

blocked

expired

other

Example: accepted

chargePointIds

integer[] · required

The charge points ids this team member has access

canPayForChargesCountryIds

integer[] · required

List of country ids for which the team member can pay for charges

Example: [1,2,3]

teamWalletChargePaymentType

TeamWalletChargePaymentType · enum · required

Enum values:

partner

operator

all

team

team_and_parent

selected_operators

none

Example: none

Default: none

teamId

integer · int64

Team id of team member

Example: 42

displayName

string | null

The team member display name, formats can be: First and Last Name, User: #id, email, or phone

Example: Casper Rasmussen

object

Operator of this team member

partnerExternalTeamId

string | null

The partner external id for the team

Example: A1B2C3BE3121

teamType

string · enum

Type of the team this member belongs to

Enum values:

personal

private

professional

operator

Example: private

userId

integer | null · int64

User id of team member. If the user does not exist yet, it will be null

Example: 1

email

string | null

Email of the team member

Example: example@monta.com

phone

string | null

Phone number of the team member

Example: +4512345678

note

string | null

Note for team member

Example: A Note

invitedAt

string | null · date-time

Date of team member was invited to join the team

Example: 2022-05-12T15:56:45.99Z

invitedBy

string | null

Email of the team member that invited this team member

Example: example@monta.com

acceptedAt

string | null · date-time

Date of team member accepted the invitation

Example: 2022-05-12T15:56:45.99Z

acceptedBy

string | null

Email of the team member that accepted the invitation

Example: example@monta.com

rejectedAt

string | null · date-time

Date of team member rejected the invitation

Example: 2022-05-12T15:56:45.99Z

createdAt

string | null · date-time

Date the team member was created

Example: 2022-05-12T15:56:45.99Z

updatedAt

string | null · date-time

Date the team member was updated

Example: 2022-05-12T16:56:45.99Z

deletedAt

string | null · date-time

Date the team member was deleted

Example: 2022-05-12T16:56:45.99Z

priceGroupId

integer | null · int64

The price group for this team member

Example: 1

costGroupId

integer | null · int64

The cost group for this team member

Example: 1

costCenterId

integer | null · int64

The cost center assigned to this team member. null when none is assigned, and always null while the invitation is still pending.

Example: 1

teamMemberProfileId

integer | null · int64

The team member profile id to apply to this team member

Example: 1

canConfigureChargePoints

boolean

Indicates if the team member can configure charge points

Example: false

Default: false

canPayWithTeamWallet

boolean

Indicates if the team member can pay with the team wallet in the Monta shop (e.g. charge keys, stickers). Team wallet payment for charging sessions is controlled by teamWalletChargePaymentType

Example: false

Default: false

canManageTeamWallet

boolean

Indicates if team member has access to withdraw and deposit from your team wallet to your bank account

Example: false

Default: false

canDepositToWallet

boolean | null

Indicates if team member can deposit to team wallet

canWithdrawFromWallet

boolean | null

Indicates if team member can withdraw from team wallet

canManageChargeKeys

boolean | null

Indicates if team member can manage charge keys for the team

canRequestSponsoring

boolean

Indicates if the team member is allowed to request sponsoring from this team for their charge point

Example: false

Default: false

canManageTeamMembers

boolean

Indicates that the team member can view and manage other members settings

Example: false

Default: false

partnerExternalId

string | null

External Id of this entity, managed by you

Example: ACME-12345

object | null

Custom JSON payload for this entity, managed by you.
Note: the expected shape is a flat JSON object with named keys.

Example: {"internalId":"ACME-12345","department":"Fleet"}

kwhPriceCapAc

number | null

Maximum price per kWh in the team currency that the team will cover when charging on AC.

Example: 2.5

kwhPriceCapDc

number | null

Maximum price per kWh in the team currency that the team will cover when charging on DC.

Example: 5

sponsoredPriceGroupId

integer | null · int64

Price group used to reimburse this team member for home charging. null means the employee's own cost price group is cloned at SCP creation time.

Example: 1

autoApproveElectricityCost

boolean

When true, employee-submitted electricity costs are auto-approved for SCPs created for this team member.

Example: false

Default: false

reimbursementEnabled

boolean

Master switch — whether the team member participates in home reimbursement. Gates auto-creation of sponsored charge points on acceptance and on charge-point install.

Example: false

Default: false

reimbursementPayoutSchedule

string · enum

Default payout schedule applied to sponsored charge points created for this team member.

Enum values:

end-of-month

realtime

other

Example: end-of-month

reimbursementSubscription

boolean

Whether the operator reimburses the charge-point subscription price for this team member.

Example: false

Default: false

GET/api/v1/team-members/{id}

curl https://partner-api.monta.com/api/v1/team-members/:id \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "id": 1,
  "teamId": 42,
  "displayName": "Casper Rasmussen",
  "operator": {
    "id": 14,
    "name": "Monta",
    "identifier": "monta",
    "partnerId": 1,
    "vatNumber": "FOO-123-ABC"
  },
  "partnerExternalTeamId": "A1B2C3BE3121",
  "teamType": "private",
  "userId": 1,
  "email": "example@monta.com",
  "phone": "+4512345678",
  "role": "admin",
  "access": "all",
  "state": "accepted",
  "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",
  "chargePointIds": [
    0
  ],
  "priceGroupId": 1,
  "costGroupId": 1,
  "costCenterId": 1,
  "teamMemberProfileId": 1,
  "canConfigureChargePoints": false,
  "canPayWithTeamWallet": false,
  "canManageTeamWallet": false,
  "canDepositToWallet": true,
  "canWithdrawFromWallet": true,
  "canManageChargeKeys": true,
  "canRequestSponsoring": false,
  "canManageTeamMembers": false,
  "canPayForChargesCountryIds": [
    1,
    2,
    3
  ],
  "teamWalletChargePaymentType": "none",
  "partnerExternalId": "ACME-12345",
  "partnerCustomPayload": {
    "internalId": "ACME-12345",
    "department": "Fleet"
  },
  "kwhPriceCapAc": 2.5,
  "kwhPriceCapDc": 5,
  "sponsoredPriceGroupId": 1,
  "autoApproveElectricityCost": false,
  "reimbursementEnabled": false,
  "reimbursementPayoutSchedule": "end-of-month",
  "reimbursementSubscription": false
}

json

application/json

Patch a team member.

PATCH

https://partner-api.monta.com

/api/v1/team-members/{id}

Required scope: team-members:write
Organization authorization: supported

Patch a team member. › path Parameters

id

integer · int64 · required

Patch a team member. › Request Body

PatchTeamMember

chargePointIds

array | null

Ids of the charge points to patch this team member with

Example: [1,2,3,4]

role

string · enum

Role for this member within the team

Enum values:

admin

user

other

Example: admin

priceGroupId

integer | null · int64

The price group for this team member

Example: 1

costGroupId

integer | null · int64

The cost group for this team member

Example: 1

teamMemberProfileId

integer | null · int64

The team member profile id to apply to this team member

Example: 1

canConfigureChargePoints

boolean | null

Indicates if the team member can configure charge points

Example: false

Default: false

canPayWithTeamWallet

boolean | null

Gives the team member access to pay with the team wallet in the Monta shop (e.g. charge keys, stickers). Team wallet payment for charging sessions is controlled by teamWalletChargePaymentType

Example: false

Default: false

canDepositToWallet

boolean | null

Gives the team member permission to deposit to the team wallet

canWithdrawFromWallet

boolean | null

Gives the team member permission to withdraw from the team wallet

canManageChargeKeys

boolean | null

Gives the team member permission to manage charge keys for the team

canRequestSponsoring

boolean | null

Allows the team member to request sponsoring from this team for their charge point

Example: false

Default: false

canManageTeamMembers

boolean | null

Allows the team member to view and manage other members settings

Example: false

Default: false

teamWalletChargePaymentType

string · enum

Enum values:

partner

operator

all

team

team_and_parent

selected_operators

none

Example: none

Default: none

canPayForChargesCountryIds

array | null

List of country ids for which the team member can pay for charges

Example: [1,2,3]

kwhPriceCapAc

number | null

Maximum price per kWh in the team currency that the team will cover when charging on AC.

Example: 2.5

kwhPriceCapDc

number | null

Maximum price per kWh in the team currency that the team will cover when charging on DC.

Example: 5

note

string | null

A note for the team member

Example: Welcome to the Monta team

partnerExternalId

string | null

External Id of this entity, managed by you.

Example: ACME-12345

object | null

Custom JSON payload for this entity, managed by you.
Note: the expected shape is a flat JSON object with named keys. The payload is limited to 1000 characters.

Example: {"internalId":"ACME-12345","department":"Fleet"}

sponsoredPriceGroupId

integer | null · int64

Price group used to reimburse this team member for home charging. Omit to leave unchanged.

Example: 1

autoApproveElectricityCost

boolean | null

When true, employee-submitted electricity costs are auto-approved for SCPs created for this team member.

Example: false

reimbursementEnabled

boolean | null

Master switch — whether the team member participates in home reimbursement.

Example: false

reimbursementPayoutSchedule

string · enum

Default payout schedule applied to sponsored charge points created for this team member.

Enum values:

end-of-month

realtime

other

Example: end-of-month

reimbursementSubscription

boolean | null

Whether the operator reimburses the charge-point subscription price.

Example: false

costCenterId

integer | null · int32

The cost center id to assign to the team member.
Note: Send null to clear the assignment; omit the field to leave it unchanged.

Example: 1

Patch a team member. › Responses

Updated Team member with provided id

TeamMember

id

integer · int64 · required

Id of the team member

Example: 1

role

string · enum · required

Role of the this member within the team

Enum values:

admin

user

other

Example: admin

access

string · enum · required

Indicates if the user has access to all charge points or only to selected charge points

Enum values:

all

selected

other

Example: all

state

string · enum · required

State of the invitation

Enum values:

requested

invited

rejected

accepted

blocked

expired

other

Example: accepted

chargePointIds

integer[] · required

The charge points ids this team member has access

canPayForChargesCountryIds

integer[] · required

List of country ids for which the team member can pay for charges

Example: [1,2,3]

teamWalletChargePaymentType

TeamWalletChargePaymentType · enum · required

Enum values:

partner

operator

all

team

team_and_parent

selected_operators

none

Example: none

Default: none

teamId

integer · int64

Team id of team member

Example: 42

displayName

string | null

The team member display name, formats can be: First and Last Name, User: #id, email, or phone

Example: Casper Rasmussen

object

Operator of this team member

partnerExternalTeamId

string | null

The partner external id for the team

Example: A1B2C3BE3121

teamType

string · enum

Type of the team this member belongs to

Enum values:

personal

private

professional

operator

Example: private

userId

integer | null · int64

User id of team member. If the user does not exist yet, it will be null

Example: 1

email

string | null

Email of the team member

Example: example@monta.com

phone

string | null

Phone number of the team member

Example: +4512345678

note

string | null

Note for team member

Example: A Note

invitedAt

string | null · date-time

Date of team member was invited to join the team

Example: 2022-05-12T15:56:45.99Z

invitedBy

string | null

Email of the team member that invited this team member

Example: example@monta.com

acceptedAt

string | null · date-time

Date of team member accepted the invitation

Example: 2022-05-12T15:56:45.99Z

acceptedBy

string | null

Email of the team member that accepted the invitation

Example: example@monta.com

rejectedAt

string | null · date-time

Date of team member rejected the invitation

Example: 2022-05-12T15:56:45.99Z

createdAt

string | null · date-time

Date the team member was created

Example: 2022-05-12T15:56:45.99Z

updatedAt

string | null · date-time

Date the team member was updated

Example: 2022-05-12T16:56:45.99Z

deletedAt

string | null · date-time

Date the team member was deleted

Example: 2022-05-12T16:56:45.99Z

priceGroupId

integer | null · int64

The price group for this team member

Example: 1

costGroupId

integer | null · int64

The cost group for this team member

Example: 1

costCenterId

integer | null · int64

The cost center assigned to this team member. null when none is assigned, and always null while the invitation is still pending.

Example: 1

teamMemberProfileId

integer | null · int64

The team member profile id to apply to this team member

Example: 1

canConfigureChargePoints

boolean

Indicates if the team member can configure charge points

Example: false

Default: false

canPayWithTeamWallet

boolean

Indicates if the team member can pay with the team wallet in the Monta shop (e.g. charge keys, stickers). Team wallet payment for charging sessions is controlled by teamWalletChargePaymentType

Example: false

Default: false

canManageTeamWallet

boolean

Indicates if team member has access to withdraw and deposit from your team wallet to your bank account

Example: false

Default: false

canDepositToWallet

boolean | null

Indicates if team member can deposit to team wallet

canWithdrawFromWallet

boolean | null

Indicates if team member can withdraw from team wallet

canManageChargeKeys

boolean | null

Indicates if team member can manage charge keys for the team

canRequestSponsoring

boolean

Indicates if the team member is allowed to request sponsoring from this team for their charge point

Example: false

Default: false

canManageTeamMembers

boolean

Indicates that the team member can view and manage other members settings

Example: false

Default: false

partnerExternalId

string | null

External Id of this entity, managed by you

Example: ACME-12345

object | null

Custom JSON payload for this entity, managed by you.
Note: the expected shape is a flat JSON object with named keys.

Example: {"internalId":"ACME-12345","department":"Fleet"}

kwhPriceCapAc

number | null

Maximum price per kWh in the team currency that the team will cover when charging on AC.

Example: 2.5

kwhPriceCapDc

number | null

Maximum price per kWh in the team currency that the team will cover when charging on DC.

Example: 5

sponsoredPriceGroupId

integer | null · int64

Price group used to reimburse this team member for home charging. null means the employee's own cost price group is cloned at SCP creation time.

Example: 1

autoApproveElectricityCost

boolean

When true, employee-submitted electricity costs are auto-approved for SCPs created for this team member.

Example: false

Default: false

reimbursementEnabled

boolean

Master switch — whether the team member participates in home reimbursement. Gates auto-creation of sponsored charge points on acceptance and on charge-point install.

Example: false

Default: false

reimbursementPayoutSchedule

string · enum

Default payout schedule applied to sponsored charge points created for this team member.

Enum values:

end-of-month

realtime

other

Example: end-of-month

reimbursementSubscription

boolean

Whether the operator reimburses the charge-point subscription price for this team member.

Example: false

Default: false

PATCH/api/v1/team-members/{id}

curl https://partner-api.monta.com/api/v1/team-members/:id \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "chargePointIds": [
    1,
    2,
    3,
    4
  ],
  "role": "admin",
  "priceGroupId": 1,
  "costGroupId": 1,
  "teamMemberProfileId": 1,
  "canConfigureChargePoints": false,
  "canPayWithTeamWallet": false,
  "canManageTeamWallet": true,
  "canDepositToWallet": true,
  "canWithdrawFromWallet": true,
  "canManageChargeKeys": true,
  "canRequestSponsoring": false,
  "canManageTeamMembers": false,
  "teamWalletChargePaymentType": "none",
  "canPayForChargesCountryIds": [
    1,
    2,
    3
  ],
  "kwhPriceCapAc": 2.5,
  "kwhPriceCapDc": 5,
  "note": "Welcome to the Monta team",
  "partnerExternalId": "ACME-12345",
  "partnerCustomPayload": {
    "internalId": "ACME-12345",
    "department": "Fleet"
  },
  "sponsoredPriceGroupId": 1,
  "autoApproveElectricityCost": false,
  "reimbursementEnabled": false,
  "reimbursementPayoutSchedule": "end-of-month",
  "reimbursementSubscription": false,
  "costCenterId": 1
}'

Example Request Body

{
  "chargePointIds": [
    1,
    2,
    3,
    4
  ],
  "role": "admin",
  "priceGroupId": 1,
  "costGroupId": 1,
  "teamMemberProfileId": 1,
  "canConfigureChargePoints": false,
  "canPayWithTeamWallet": false,
  "canManageTeamWallet": true,
  "canDepositToWallet": true,
  "canWithdrawFromWallet": true,
  "canManageChargeKeys": true,
  "canRequestSponsoring": false,
  "canManageTeamMembers": false,
  "teamWalletChargePaymentType": "none",
  "canPayForChargesCountryIds": [
    1,
    2,
    3
  ],
  "kwhPriceCapAc": 2.5,
  "kwhPriceCapDc": 5,
  "note": "Welcome to the Monta team",
  "partnerExternalId": "ACME-12345",
  "partnerCustomPayload": {
    "internalId": "ACME-12345",
    "department": "Fleet"
  },
  "sponsoredPriceGroupId": 1,
  "autoApproveElectricityCost": false,
  "reimbursementEnabled": false,
  "reimbursementPayoutSchedule": "end-of-month",
  "reimbursementSubscription": false,
  "costCenterId": 1
}

json

Example Responses

{
  "id": 1,
  "teamId": 42,
  "displayName": "Casper Rasmussen",
  "operator": {
    "id": 14,
    "name": "Monta",
    "identifier": "monta",
    "partnerId": 1,
    "vatNumber": "FOO-123-ABC"
  },
  "partnerExternalTeamId": "A1B2C3BE3121",
  "teamType": "private",
  "userId": 1,
  "email": "example@monta.com",
  "phone": "+4512345678",
  "role": "admin",
  "access": "all",
  "state": "accepted",
  "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",
  "chargePointIds": [
    0
  ],
  "priceGroupId": 1,
  "costGroupId": 1,
  "costCenterId": 1,
  "teamMemberProfileId": 1,
  "canConfigureChargePoints": false,
  "canPayWithTeamWallet": false,
  "canManageTeamWallet": false,
  "canDepositToWallet": true,
  "canWithdrawFromWallet": true,
  "canManageChargeKeys": true,
  "canRequestSponsoring": false,
  "canManageTeamMembers": false,
  "canPayForChargesCountryIds": [
    1,
    2,
    3
  ],
  "teamWalletChargePaymentType": "none",
  "partnerExternalId": "ACME-12345",
  "partnerCustomPayload": {
    "internalId": "ACME-12345",
    "department": "Fleet"
  },
  "kwhPriceCapAc": 2.5,
  "kwhPriceCapDc": 5,
  "sponsoredPriceGroupId": 1,
  "autoApproveElectricityCost": false,
  "reimbursementEnabled": false,
  "reimbursementPayoutSchedule": "end-of-month",
  "reimbursementSubscription": false
}

json

application/json

Delete an existing team member

DELETE

https://partner-api.monta.com

/api/v1/team-members/{id}

Required scope: team-members:delete
Organization authorization: supported

Delete an existing team member › path Parameters

id

integer · int64 · required

Delete an existing team member › Responses

Team member deleted

No data returned

Approve a team member who requested to join a team

POST

https://partner-api.monta.com

/api/v1/team-members/{id}/accept

Required scope: team-members:write
Organization authorization: supported

Approve a team member who requested to join a team › path Parameters

id

integer · int64 · required

Approve a team member who requested to join a team › Responses

Team member with provided id

TeamMember

id

integer · int64 · required

Id of the team member

Example: 1

role

string · enum · required

Role of the this member within the team

Enum values:

admin

user

other

Example: admin

access

string · enum · required

Indicates if the user has access to all charge points or only to selected charge points

Enum values:

all

selected

other

Example: all

state

string · enum · required

State of the invitation

Enum values:

requested

invited

rejected

accepted

blocked

expired

other

Example: accepted

chargePointIds

integer[] · required

The charge points ids this team member has access

canPayForChargesCountryIds

integer[] · required

List of country ids for which the team member can pay for charges

Example: [1,2,3]

teamWalletChargePaymentType

TeamWalletChargePaymentType · enum · required

Enum values:

partner

operator

all

team

team_and_parent

selected_operators

none

Example: none

Default: none

teamId

integer · int64

Team id of team member

Example: 42

displayName

string | null

The team member display name, formats can be: First and Last Name, User: #id, email, or phone

Example: Casper Rasmussen

object

Operator of this team member

partnerExternalTeamId

string | null

The partner external id for the team

Example: A1B2C3BE3121

teamType

string · enum

Type of the team this member belongs to

Enum values:

personal

private

professional

operator

Example: private

userId

integer | null · int64

User id of team member. If the user does not exist yet, it will be null

Example: 1

email

string | null

Email of the team member

Example: example@monta.com

phone

string | null

Phone number of the team member

Example: +4512345678

note

string | null

Note for team member

Example: A Note

invitedAt

string | null · date-time

Date of team member was invited to join the team

Example: 2022-05-12T15:56:45.99Z

invitedBy

string | null

Email of the team member that invited this team member

Example: example@monta.com

acceptedAt

string | null · date-time

Date of team member accepted the invitation

Example: 2022-05-12T15:56:45.99Z

acceptedBy

string | null

Email of the team member that accepted the invitation

Example: example@monta.com

rejectedAt

string | null · date-time

Date of team member rejected the invitation

Example: 2022-05-12T15:56:45.99Z

createdAt

string | null · date-time

Date the team member was created

Example: 2022-05-12T15:56:45.99Z

updatedAt

string | null · date-time

Date the team member was updated

Example: 2022-05-12T16:56:45.99Z

deletedAt

string | null · date-time

Date the team member was deleted

Example: 2022-05-12T16:56:45.99Z

priceGroupId

integer | null · int64

The price group for this team member

Example: 1

costGroupId

integer | null · int64

The cost group for this team member

Example: 1

costCenterId

integer | null · int64

The cost center assigned to this team member. null when none is assigned, and always null while the invitation is still pending.

Example: 1

teamMemberProfileId

integer | null · int64

The team member profile id to apply to this team member

Example: 1

canConfigureChargePoints

boolean

Indicates if the team member can configure charge points

Example: false

Default: false

canPayWithTeamWallet

boolean

Indicates if the team member can pay with the team wallet in the Monta shop (e.g. charge keys, stickers). Team wallet payment for charging sessions is controlled by teamWalletChargePaymentType

Example: false

Default: false

canManageTeamWallet

boolean

Indicates if team member has access to withdraw and deposit from your team wallet to your bank account

Example: false

Default: false

canDepositToWallet

boolean | null

Indicates if team member can deposit to team wallet

canWithdrawFromWallet

boolean | null

Indicates if team member can withdraw from team wallet

canManageChargeKeys

boolean | null

Indicates if team member can manage charge keys for the team

canRequestSponsoring

boolean

Indicates if the team member is allowed to request sponsoring from this team for their charge point

Example: false

Default: false

canManageTeamMembers

boolean

Indicates that the team member can view and manage other members settings

Example: false

Default: false

partnerExternalId

string | null

External Id of this entity, managed by you

Example: ACME-12345

object | null

Custom JSON payload for this entity, managed by you.
Note: the expected shape is a flat JSON object with named keys.

Example: {"internalId":"ACME-12345","department":"Fleet"}

kwhPriceCapAc

number | null

Maximum price per kWh in the team currency that the team will cover when charging on AC.

Example: 2.5

kwhPriceCapDc

number | null

Maximum price per kWh in the team currency that the team will cover when charging on DC.

Example: 5

sponsoredPriceGroupId

integer | null · int64

Price group used to reimburse this team member for home charging. null means the employee's own cost price group is cloned at SCP creation time.

Example: 1

autoApproveElectricityCost

boolean

When true, employee-submitted electricity costs are auto-approved for SCPs created for this team member.

Example: false

Default: false

reimbursementEnabled

boolean

Master switch — whether the team member participates in home reimbursement. Gates auto-creation of sponsored charge points on acceptance and on charge-point install.

Example: false

Default: false

reimbursementPayoutSchedule

string · enum

Default payout schedule applied to sponsored charge points created for this team member.

Enum values:

end-of-month

realtime

other

Example: end-of-month

reimbursementSubscription

boolean

Whether the operator reimburses the charge-point subscription price for this team member.

Example: false

Default: false

POST/api/v1/team-members/{id}/accept

curl https://partner-api.monta.com/api/v1/team-members/:id/accept \
  --request POST \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "id": 1,
  "teamId": 42,
  "displayName": "Casper Rasmussen",
  "operator": {
    "id": 14,
    "name": "Monta",
    "identifier": "monta",
    "partnerId": 1,
    "vatNumber": "FOO-123-ABC"
  },
  "partnerExternalTeamId": "A1B2C3BE3121",
  "teamType": "private",
  "userId": 1,
  "email": "example@monta.com",
  "phone": "+4512345678",
  "role": "admin",
  "access": "all",
  "state": "accepted",
  "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",
  "chargePointIds": [
    0
  ],
  "priceGroupId": 1,
  "costGroupId": 1,
  "costCenterId": 1,
  "teamMemberProfileId": 1,
  "canConfigureChargePoints": false,
  "canPayWithTeamWallet": false,
  "canManageTeamWallet": false,
  "canDepositToWallet": true,
  "canWithdrawFromWallet": true,
  "canManageChargeKeys": true,
  "canRequestSponsoring": false,
  "canManageTeamMembers": false,
  "canPayForChargesCountryIds": [
    1,
    2,
    3
  ],
  "teamWalletChargePaymentType": "none",
  "partnerExternalId": "ACME-12345",
  "partnerCustomPayload": {
    "internalId": "ACME-12345",
    "department": "Fleet"
  },
  "kwhPriceCapAc": 2.5,
  "kwhPriceCapDc": 5,
  "sponsoredPriceGroupId": 1,
  "autoApproveElectricityCost": false,
  "reimbursementEnabled": false,
  "reimbursementPayoutSchedule": "end-of-month",
  "reimbursementSubscription": false
}

json

application/json

Reject a team member who requested to join a team or was invited

POST

https://partner-api.monta.com

/api/v1/team-members/{id}/reject

Required scope: team-members:write
Organization authorization: supported

Reject a team member who requested to join a team or was invited › path Parameters

id

integer · int64 · required

Reject a team member who requested to join a team or was invited › Responses

Team member with provided id

TeamMember

id

integer · int64 · required

Id of the team member

Example: 1

role

string · enum · required

Role of the this member within the team

Enum values:

admin

user

other

Example: admin

access

string · enum · required

Indicates if the user has access to all charge points or only to selected charge points

Enum values:

all

selected

other

Example: all

state

string · enum · required

State of the invitation

Enum values:

requested

invited

rejected

accepted

blocked

expired

other

Example: accepted

chargePointIds

integer[] · required

The charge points ids this team member has access

canPayForChargesCountryIds

integer[] · required

List of country ids for which the team member can pay for charges

Example: [1,2,3]

teamWalletChargePaymentType

TeamWalletChargePaymentType · enum · required

Enum values:

partner

operator

all

team

team_and_parent

selected_operators

none

Example: none

Default: none

teamId

integer · int64

Team id of team member

Example: 42

displayName

string | null

The team member display name, formats can be: First and Last Name, User: #id, email, or phone

Example: Casper Rasmussen

object

Operator of this team member

partnerExternalTeamId

string | null

The partner external id for the team

Example: A1B2C3BE3121

teamType

string · enum

Type of the team this member belongs to

Enum values:

personal

private

professional

operator

Example: private

userId

integer | null · int64

User id of team member. If the user does not exist yet, it will be null

Example: 1

email

string | null

Email of the team member

Example: example@monta.com

phone

string | null

Phone number of the team member

Example: +4512345678

note

string | null

Note for team member

Example: A Note

invitedAt

string | null · date-time

Date of team member was invited to join the team

Example: 2022-05-12T15:56:45.99Z

invitedBy

string | null

Email of the team member that invited this team member

Example: example@monta.com

acceptedAt

string | null · date-time

Date of team member accepted the invitation

Example: 2022-05-12T15:56:45.99Z

acceptedBy

string | null

Email of the team member that accepted the invitation

Example: example@monta.com

rejectedAt

string | null · date-time

Date of team member rejected the invitation

Example: 2022-05-12T15:56:45.99Z

createdAt

string | null · date-time

Date the team member was created

Example: 2022-05-12T15:56:45.99Z

updatedAt

string | null · date-time

Date the team member was updated

Example: 2022-05-12T16:56:45.99Z

deletedAt

string | null · date-time

Date the team member was deleted

Example: 2022-05-12T16:56:45.99Z

priceGroupId

integer | null · int64

The price group for this team member

Example: 1

costGroupId

integer | null · int64

The cost group for this team member

Example: 1

costCenterId

integer | null · int64

The cost center assigned to this team member. null when none is assigned, and always null while the invitation is still pending.

Example: 1

teamMemberProfileId

integer | null · int64

The team member profile id to apply to this team member

Example: 1

canConfigureChargePoints

boolean

Indicates if the team member can configure charge points

Example: false

Default: false

canPayWithTeamWallet

boolean

Indicates if the team member can pay with the team wallet in the Monta shop (e.g. charge keys, stickers). Team wallet payment for charging sessions is controlled by teamWalletChargePaymentType

Example: false

Default: false

canManageTeamWallet

boolean

Indicates if team member has access to withdraw and deposit from your team wallet to your bank account

Example: false

Default: false

canDepositToWallet

boolean | null

Indicates if team member can deposit to team wallet

canWithdrawFromWallet

boolean | null

Indicates if team member can withdraw from team wallet

canManageChargeKeys

boolean | null

Indicates if team member can manage charge keys for the team

canRequestSponsoring

boolean

Indicates if the team member is allowed to request sponsoring from this team for their charge point

Example: false

Default: false

canManageTeamMembers

boolean

Indicates that the team member can view and manage other members settings

Example: false

Default: false

partnerExternalId

string | null

External Id of this entity, managed by you

Example: ACME-12345

object | null

Custom JSON payload for this entity, managed by you.
Note: the expected shape is a flat JSON object with named keys.

Example: {"internalId":"ACME-12345","department":"Fleet"}

kwhPriceCapAc

number | null

Maximum price per kWh in the team currency that the team will cover when charging on AC.

Example: 2.5

kwhPriceCapDc

number | null

Maximum price per kWh in the team currency that the team will cover when charging on DC.

Example: 5

sponsoredPriceGroupId

integer | null · int64

Price group used to reimburse this team member for home charging. null means the employee's own cost price group is cloned at SCP creation time.

Example: 1

autoApproveElectricityCost

boolean

When true, employee-submitted electricity costs are auto-approved for SCPs created for this team member.

Example: false

Default: false

reimbursementEnabled

boolean

Master switch — whether the team member participates in home reimbursement. Gates auto-creation of sponsored charge points on acceptance and on charge-point install.

Example: false

Default: false

reimbursementPayoutSchedule

string · enum

Default payout schedule applied to sponsored charge points created for this team member.

Enum values:

end-of-month

realtime

other

Example: end-of-month

reimbursementSubscription

boolean

Whether the operator reimburses the charge-point subscription price for this team member.

Example: false

Default: false

POST/api/v1/team-members/{id}/reject

curl https://partner-api.monta.com/api/v1/team-members/:id/reject \
  --request POST \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "id": 1,
  "teamId": 42,
  "displayName": "Casper Rasmussen",
  "operator": {
    "id": 14,
    "name": "Monta",
    "identifier": "monta",
    "partnerId": 1,
    "vatNumber": "FOO-123-ABC"
  },
  "partnerExternalTeamId": "A1B2C3BE3121",
  "teamType": "private",
  "userId": 1,
  "email": "example@monta.com",
  "phone": "+4512345678",
  "role": "admin",
  "access": "all",
  "state": "accepted",
  "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",
  "chargePointIds": [
    0
  ],
  "priceGroupId": 1,
  "costGroupId": 1,
  "costCenterId": 1,
  "teamMemberProfileId": 1,
  "canConfigureChargePoints": false,
  "canPayWithTeamWallet": false,
  "canManageTeamWallet": false,
  "canDepositToWallet": true,
  "canWithdrawFromWallet": true,
  "canManageChargeKeys": true,
  "canRequestSponsoring": false,
  "canManageTeamMembers": false,
  "canPayForChargesCountryIds": [
    1,
    2,
    3
  ],
  "teamWalletChargePaymentType": "none",
  "partnerExternalId": "ACME-12345",
  "partnerCustomPayload": {
    "internalId": "ACME-12345",
    "department": "Fleet"
  },
  "kwhPriceCapAc": 2.5,
  "kwhPriceCapDc": 5,
  "sponsoredPriceGroupId": 1,
  "autoApproveElectricityCost": false,
  "reimbursementEnabled": false,
  "reimbursementPayoutSchedule": "end-of-month",
  "reimbursementSubscription": false
}

json

application/json

Resend an invite to a team member and reset expiry date.

POST

https://partner-api.monta.com

/api/v1/team-members/{id}/resend-invite

Required scope: team-members:write
Organization authorization: supported

Resend an invite to a team member and reset expiry date. › path Parameters

id

integer · int64 · required

Resend an invite to a team member and reset expiry date. › Responses

Team member with provided id

TeamMember

id

integer · int64 · required

Id of the team member

Example: 1

role

string · enum · required

Role of the this member within the team

Enum values:

admin

user

other

Example: admin

access

string · enum · required

Indicates if the user has access to all charge points or only to selected charge points

Enum values:

all

selected

other

Example: all

state

string · enum · required

State of the invitation

Enum values:

requested

invited

rejected

accepted

blocked

expired

other

Example: accepted

chargePointIds

integer[] · required

The charge points ids this team member has access

canPayForChargesCountryIds

integer[] · required

List of country ids for which the team member can pay for charges

Example: [1,2,3]

teamWalletChargePaymentType

TeamWalletChargePaymentType · enum · required

Enum values:

partner

operator

all

team

team_and_parent

selected_operators

none

Example: none

Default: none

teamId

integer · int64

Team id of team member

Example: 42

displayName

string | null

The team member display name, formats can be: First and Last Name, User: #id, email, or phone

Example: Casper Rasmussen

object

Operator of this team member

partnerExternalTeamId

string | null

The partner external id for the team

Example: A1B2C3BE3121

teamType

string · enum

Type of the team this member belongs to

Enum values:

personal

private

professional

operator

Example: private

userId

integer | null · int64

User id of team member. If the user does not exist yet, it will be null

Example: 1

email

string | null

Email of the team member

Example: example@monta.com

phone

string | null

Phone number of the team member

Example: +4512345678

note

string | null

Note for team member

Example: A Note

invitedAt

string | null · date-time

Date of team member was invited to join the team

Example: 2022-05-12T15:56:45.99Z

invitedBy

string | null

Email of the team member that invited this team member

Example: example@monta.com

acceptedAt

string | null · date-time

Date of team member accepted the invitation

Example: 2022-05-12T15:56:45.99Z

acceptedBy

string | null

Email of the team member that accepted the invitation

Example: example@monta.com

rejectedAt

string | null · date-time

Date of team member rejected the invitation

Example: 2022-05-12T15:56:45.99Z

createdAt

string | null · date-time

Date the team member was created

Example: 2022-05-12T15:56:45.99Z

updatedAt

string | null · date-time

Date the team member was updated

Example: 2022-05-12T16:56:45.99Z

deletedAt

string | null · date-time

Date the team member was deleted

Example: 2022-05-12T16:56:45.99Z

priceGroupId

integer | null · int64

The price group for this team member

Example: 1

costGroupId

integer | null · int64

The cost group for this team member

Example: 1

costCenterId

integer | null · int64

The cost center assigned to this team member. null when none is assigned, and always null while the invitation is still pending.

Example: 1

teamMemberProfileId

integer | null · int64

The team member profile id to apply to this team member

Example: 1

canConfigureChargePoints

boolean

Indicates if the team member can configure charge points

Example: false

Default: false

canPayWithTeamWallet

boolean

Indicates if the team member can pay with the team wallet in the Monta shop (e.g. charge keys, stickers). Team wallet payment for charging sessions is controlled by teamWalletChargePaymentType

Example: false

Default: false

canManageTeamWallet

boolean

Indicates if team member has access to withdraw and deposit from your team wallet to your bank account

Example: false

Default: false

canDepositToWallet

boolean | null

Indicates if team member can deposit to team wallet

canWithdrawFromWallet

boolean | null

Indicates if team member can withdraw from team wallet

canManageChargeKeys

boolean | null

Indicates if team member can manage charge keys for the team

canRequestSponsoring

boolean

Indicates if the team member is allowed to request sponsoring from this team for their charge point

Example: false

Default: false

canManageTeamMembers

boolean

Indicates that the team member can view and manage other members settings

Example: false

Default: false

partnerExternalId

string | null

External Id of this entity, managed by you

Example: ACME-12345

object | null

Custom JSON payload for this entity, managed by you.
Note: the expected shape is a flat JSON object with named keys.

Example: {"internalId":"ACME-12345","department":"Fleet"}

kwhPriceCapAc

number | null

Maximum price per kWh in the team currency that the team will cover when charging on AC.

Example: 2.5

kwhPriceCapDc

number | null

Maximum price per kWh in the team currency that the team will cover when charging on DC.

Example: 5

sponsoredPriceGroupId

integer | null · int64

Price group used to reimburse this team member for home charging. null means the employee's own cost price group is cloned at SCP creation time.

Example: 1

autoApproveElectricityCost

boolean

When true, employee-submitted electricity costs are auto-approved for SCPs created for this team member.

Example: false

Default: false

reimbursementEnabled

boolean

Master switch — whether the team member participates in home reimbursement. Gates auto-creation of sponsored charge points on acceptance and on charge-point install.

Example: false

Default: false

reimbursementPayoutSchedule

string · enum

Default payout schedule applied to sponsored charge points created for this team member.

Enum values:

end-of-month

realtime

other

Example: end-of-month

reimbursementSubscription

boolean

Whether the operator reimburses the charge-point subscription price for this team member.

Example: false

Default: false

POST/api/v1/team-members/{id}/resend-invite

curl https://partner-api.monta.com/api/v1/team-members/:id/resend-invite \
  --request POST \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "id": 1,
  "teamId": 42,
  "displayName": "Casper Rasmussen",
  "operator": {
    "id": 14,
    "name": "Monta",
    "identifier": "monta",
    "partnerId": 1,
    "vatNumber": "FOO-123-ABC"
  },
  "partnerExternalTeamId": "A1B2C3BE3121",
  "teamType": "private",
  "userId": 1,
  "email": "example@monta.com",
  "phone": "+4512345678",
  "role": "admin",
  "access": "all",
  "state": "accepted",
  "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",
  "chargePointIds": [
    0
  ],
  "priceGroupId": 1,
  "costGroupId": 1,
  "costCenterId": 1,
  "teamMemberProfileId": 1,
  "canConfigureChargePoints": false,
  "canPayWithTeamWallet": false,
  "canManageTeamWallet": false,
  "canDepositToWallet": true,
  "canWithdrawFromWallet": true,
  "canManageChargeKeys": true,
  "canRequestSponsoring": false,
  "canManageTeamMembers": false,
  "canPayForChargesCountryIds": [
    1,
    2,
    3
  ],
  "teamWalletChargePaymentType": "none",
  "partnerExternalId": "ACME-12345",
  "partnerCustomPayload": {
    "internalId": "ACME-12345",
    "department": "Fleet"
  },
  "kwhPriceCapAc": 2.5,
  "kwhPriceCapDc": 5,
  "sponsoredPriceGroupId": 1,
  "autoApproveElectricityCost": false,
  "reimbursementEnabled": false,
  "reimbursementPayoutSchedule": "end-of-month",
  "reimbursementSubscription": false
}

json

application/json

Transfer team ownership to another team member

PATCH

https://partner-api.monta.com

/api/v1/team-members/{id}/transfer-ownership

Transfers ownership of the team to another member of the same team. The team's owner is reassigned to the target member, all team charge points are reassigned to the new owner, and the target member is promoted to admin.

Required scope: team-members:write
Organization authorization: supported

Transfer team ownership to another team member › path Parameters

id

integer · int64 · required

Transfer team ownership to another team member › Responses

Team member with provided id, now owning the team

TeamMember

id

integer · int64 · required

Id of the team member

Example: 1

role

string · enum · required

Role of the this member within the team

Enum values:

admin

user

other

Example: admin

access

string · enum · required

Indicates if the user has access to all charge points or only to selected charge points

Enum values:

all

selected

other

Example: all

state

string · enum · required

State of the invitation

Enum values:

requested

invited

rejected

accepted

blocked

expired

other

Example: accepted

chargePointIds

integer[] · required

The charge points ids this team member has access

canPayForChargesCountryIds

integer[] · required

List of country ids for which the team member can pay for charges

Example: [1,2,3]

teamWalletChargePaymentType

TeamWalletChargePaymentType · enum · required

Enum values:

partner

operator

all

team

team_and_parent

selected_operators

none

Example: none

Default: none

teamId

integer · int64

Team id of team member

Example: 42

displayName

string | null

The team member display name, formats can be: First and Last Name, User: #id, email, or phone

Example: Casper Rasmussen

object

Operator of this team member

partnerExternalTeamId

string | null

The partner external id for the team

Example: A1B2C3BE3121

teamType

string · enum

Type of the team this member belongs to

Enum values:

personal

private

professional

operator

Example: private

userId

integer | null · int64

User id of team member. If the user does not exist yet, it will be null

Example: 1

email

string | null

Email of the team member

Example: example@monta.com

phone

string | null

Phone number of the team member

Example: +4512345678

note

string | null

Note for team member

Example: A Note

invitedAt

string | null · date-time

Date of team member was invited to join the team

Example: 2022-05-12T15:56:45.99Z

invitedBy

string | null

Email of the team member that invited this team member

Example: example@monta.com

acceptedAt

string | null · date-time

Date of team member accepted the invitation

Example: 2022-05-12T15:56:45.99Z

acceptedBy

string | null

Email of the team member that accepted the invitation

Example: example@monta.com

rejectedAt

string | null · date-time

Date of team member rejected the invitation

Example: 2022-05-12T15:56:45.99Z

createdAt

string | null · date-time

Date the team member was created

Example: 2022-05-12T15:56:45.99Z

updatedAt

string | null · date-time

Date the team member was updated

Example: 2022-05-12T16:56:45.99Z

deletedAt

string | null · date-time

Date the team member was deleted

Example: 2022-05-12T16:56:45.99Z

priceGroupId

integer | null · int64

The price group for this team member

Example: 1

costGroupId

integer | null · int64

The cost group for this team member

Example: 1

costCenterId

integer | null · int64

The cost center assigned to this team member. null when none is assigned, and always null while the invitation is still pending.

Example: 1

teamMemberProfileId

integer | null · int64

The team member profile id to apply to this team member

Example: 1

canConfigureChargePoints

boolean

Indicates if the team member can configure charge points

Example: false

Default: false

canPayWithTeamWallet

boolean

Indicates if the team member can pay with the team wallet in the Monta shop (e.g. charge keys, stickers). Team wallet payment for charging sessions is controlled by teamWalletChargePaymentType

Example: false

Default: false

canManageTeamWallet

boolean

Indicates if team member has access to withdraw and deposit from your team wallet to your bank account

Example: false

Default: false

canDepositToWallet

boolean | null

Indicates if team member can deposit to team wallet

canWithdrawFromWallet

boolean | null

Indicates if team member can withdraw from team wallet

canManageChargeKeys

boolean | null

Indicates if team member can manage charge keys for the team

canRequestSponsoring

boolean

Indicates if the team member is allowed to request sponsoring from this team for their charge point

Example: false

Default: false

canManageTeamMembers

boolean

Indicates that the team member can view and manage other members settings

Example: false

Default: false

partnerExternalId

string | null

External Id of this entity, managed by you

Example: ACME-12345

object | null

Custom JSON payload for this entity, managed by you.
Note: the expected shape is a flat JSON object with named keys.

Example: {"internalId":"ACME-12345","department":"Fleet"}

kwhPriceCapAc

number | null

Maximum price per kWh in the team currency that the team will cover when charging on AC.

Example: 2.5

kwhPriceCapDc

number | null

Maximum price per kWh in the team currency that the team will cover when charging on DC.

Example: 5

sponsoredPriceGroupId

integer | null · int64

Price group used to reimburse this team member for home charging. null means the employee's own cost price group is cloned at SCP creation time.

Example: 1

autoApproveElectricityCost

boolean

When true, employee-submitted electricity costs are auto-approved for SCPs created for this team member.

Example: false

Default: false

reimbursementEnabled

boolean

Master switch — whether the team member participates in home reimbursement. Gates auto-creation of sponsored charge points on acceptance and on charge-point install.

Example: false

Default: false

reimbursementPayoutSchedule

string · enum

Default payout schedule applied to sponsored charge points created for this team member.

Enum values:

end-of-month

realtime

other

Example: end-of-month

reimbursementSubscription

boolean

Whether the operator reimburses the charge-point subscription price for this team member.

Example: false

Default: false

PATCH/api/v1/team-members/{id}/transfer-ownership

curl https://partner-api.monta.com/api/v1/team-members/:id/transfer-ownership \
  --request PATCH \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "id": 1,
  "teamId": 42,
  "displayName": "Casper Rasmussen",
  "operator": {
    "id": 14,
    "name": "Monta",
    "identifier": "monta",
    "partnerId": 1,
    "vatNumber": "FOO-123-ABC"
  },
  "partnerExternalTeamId": "A1B2C3BE3121",
  "teamType": "private",
  "userId": 1,
  "email": "example@monta.com",
  "phone": "+4512345678",
  "role": "admin",
  "access": "all",
  "state": "accepted",
  "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",
  "chargePointIds": [
    0
  ],
  "priceGroupId": 1,
  "costGroupId": 1,
  "costCenterId": 1,
  "teamMemberProfileId": 1,
  "canConfigureChargePoints": false,
  "canPayWithTeamWallet": false,
  "canManageTeamWallet": false,
  "canDepositToWallet": true,
  "canWithdrawFromWallet": true,
  "canManageChargeKeys": true,
  "canRequestSponsoring": false,
  "canManageTeamMembers": false,
  "canPayForChargesCountryIds": [
    1,
    2,
    3
  ],
  "teamWalletChargePaymentType": "none",
  "partnerExternalId": "ACME-12345",
  "partnerCustomPayload": {
    "internalId": "ACME-12345",
    "department": "Fleet"
  },
  "kwhPriceCapAc": 2.5,
  "kwhPriceCapDc": 5,
  "sponsoredPriceGroupId": 1,
  "autoApproveElectricityCost": false,
  "reimbursementEnabled": false,
  "reimbursementPayoutSchedule": "end-of-month",
  "reimbursementSubscription": false
}

json

application/json

Team Member Profiles (Member Groups)Team bank accounts