Webhooks

Get your webhook config

GET

https://partner-api.monta.com

/api/v1/webhooks/config

Required scope: manage-webhooks:read

Get your webhook config › Responses

Your Webhook config.

WebhookConfig

webhookUrl

string · maxLength: 512 · pattern: https://(?!(.*monta\… · required

A HTTPS URL to send the webhook payload to when an event occurs.

Example: https://partner1.com/webhooks/monta

webhookSecret

string · minLength: 16 · maxLength: 191 · required

A cryptoghrapic secret used to sign the webhook payload.

Example: FEC64907-DE3A-4EEB-9DA8-843D45AFF00C

eventTypes

WebhookEntry.EventType[] · maxItems: 512 · required

A list of event types to subscribe to.

Enum values:

charges

charge-points

sites

users

team-members

teams

installer-jobs

wallet-transactions

Example: ["charges","team-members"]

object

Custom headers to send with the webhook request. Note: Maximum of 5 headers are allowed. Must start with 'X-' (case-insensitive).

Example: {"headers":{"x-plus":"123","x-minus":"456"}}

teamIds

array | null · maxItems: 100

An optional list of team IDs. When set, only webhook events related to charge points belonging to one of the specified teams will be delivered. If omitted or set to null, events for all teams are delivered (current behaviour).

Example: [12345,67890]

Update your webhook config

PUT

https://partner-api.monta.com

/api/v1/webhooks/config

Required scope: manage-webhooks:write

Update your webhook config › Request Body

WebhookConfig

webhookUrl

string · maxLength: 512 · pattern: https://(?!(.*monta\… · required

A HTTPS URL to send the webhook payload to when an event occurs.

Example: https://partner1.com/webhooks/monta

webhookSecret

string · minLength: 16 · maxLength: 191 · required

A cryptoghrapic secret used to sign the webhook payload.

Example: FEC64907-DE3A-4EEB-9DA8-843D45AFF00C

eventTypes

WebhookEntry.EventType[] · maxItems: 512 · required

A list of event types to subscribe to.

Enum values:

charges

charge-points

sites

users

team-members

teams

installer-jobs

wallet-transactions

Example: ["charges","team-members"]

object

Custom headers to send with the webhook request. Note: Maximum of 5 headers are allowed. Must start with 'X-' (case-insensitive).

Example: {"headers":{"x-plus":"123","x-minus":"456"}}

teamIds

array | null · maxItems: 100

Example: [12345,67890]

Update your webhook config › Responses

Webhook config successfully updated.

WebhookConfig

webhookUrl

string · maxLength: 512 · pattern: https://(?!(.*monta\… · required

A HTTPS URL to send the webhook payload to when an event occurs.

Example: https://partner1.com/webhooks/monta

webhookSecret

string · minLength: 16 · maxLength: 191 · required

A cryptoghrapic secret used to sign the webhook payload.

Example: FEC64907-DE3A-4EEB-9DA8-843D45AFF00C

eventTypes

WebhookEntry.EventType[] · maxItems: 512 · required

A list of event types to subscribe to.

Enum values:

charges

charge-points

sites

users

team-members

teams

installer-jobs

wallet-transactions

Example: ["charges","team-members"]

object

Custom headers to send with the webhook request. Note: Maximum of 5 headers are allowed. Must start with 'X-' (case-insensitive).

Example: {"headers":{"x-plus":"123","x-minus":"456"}}

teamIds

array | null · maxItems: 100

Example: [12345,67890]

PUT/api/v1/webhooks/config

curl https://partner-api.monta.com/api/v1/webhooks/config \
  --request PUT \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "webhookUrl": "https://partner1.com/webhooks/monta",
  "webhookSecret": "FEC64907-DE3A-4EEB-9DA8-843D45AFF00C",
  "eventTypes": [
    "charges",
    "team-members"
  ],
  "customHeaders": {
    "headers": {
      "x-plus": "123",
      "x-minus": "456"
    }
  },
  "teamIds": [
    12345,
    67890
  ]
}'

Example Request Body

{
  "webhookUrl": "https://partner1.com/webhooks/monta",
  "webhookSecret": "FEC64907-DE3A-4EEB-9DA8-843D45AFF00C",
  "eventTypes": [
    "charges",
    "team-members"
  ],
  "customHeaders": {
    "headers": {
      "x-plus": "123",
      "x-minus": "456"
    }
  },
  "teamIds": [
    12345,
    67890
  ]
}

json

Example Responses

{
  "webhookUrl": "https://partner1.com/webhooks/monta",
  "webhookSecret": "FEC64907-DE3A-4EEB-9DA8-843D45AFF00C",
  "eventTypes": [
    "charges",
    "team-members"
  ],
  "customHeaders": {
    "headers": {
      "x-plus": "123",
      "x-minus": "456"
    }
  },
  "teamIds": [
    12345,
    67890
  ]
}

json

application/json

Delete webhook config

DELETE

https://partner-api.monta.com

/api/v1/webhooks/config

Required scope: manage-webhooks:delete

Delete webhook config › Responses

Successfully deleted webhook configuration

No data returned

Retrieve webhook entries

GET

https://partner-api.monta.com

/api/v1/webhooks/entries

This endpoint can help you debug pending/failed webhook entries. Required scope: webhooks:read

Retrieve webhook entries › 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

status

string | null · enum

Filter to retrieve entries by status

Enum values:

pending

completed

failed

Example: failed

Retrieve webhook entries › Responses

List of webhook entries for your consumer in the past 24 hours

OffsetBasedResponse_73

WebhookEntry[] · required

MontaPage.Meta · required

GET/api/v1/webhooks/entries

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

Example Responses

{
  "data": [
    {
      "id": 1,
      "consumerId": 1,
      "operatorId": 1,
      "eventType": "charge-points",
      "payload": "See [Charge](/reference/get-charge) payload",
      "status": "completed",
      "error": {
        "errorCode": "500",
        "errorMessage": "Bad Gateway: The server is unreachable at this time."
      },
      "createdAt": "2022-05-12T15:56:45.99Z",
      "updatedAt": "2022-05-12T16:56:45.99Z"
    }
  ],
  "meta": {
    "itemCount": 0,
    "currentPage": 0,
    "perPage": 0,
    "totalPageCount": 0,
    "totalItemCount": 0
  }
}

json

application/json

Replay failed webhook entries

POST

https://partner-api.monta.com

/api/v1/webhooks/entries/replay

Queues your failed webhook entries for delivery again, with their retries reset. Narrow the replay with ids, or with fromDate (optionally toDate and eventTypes); one of ids or fromDate is required. Note that we only persist entries for past 24 hours. Required scope: manage-webhooks:write

Replay failed webhook entries › Request Body

WebhookEntryReplay

ids

array | null · minItems: 1 · maxItems: 1000

Ids of the failed entries to replay.

Example: [1,2,3]

fromDate

string | null · date-time

Replay failed entries created at or after this time.

Example: 2026-09-22T08:00:00Z

toDate

string | null · date-time

Replay failed entries created at or before this time.

Example: 2026-09-22T20:00:00Z

eventTypes

array | null · minItems: 1 · maxItems: 512

Only replay failed entries of these event types.

Enum values:

charges

charge-points

sites

users

team-members

teams

installer-jobs

wallet-transactions

Example: ["charges"]

Replay failed webhook entries › Responses

Number of failed entries queued for delivery again.

WebhookEntryReplayResult

replayed

integer · int32

Number of failed entries queued for delivery again.

Example: 42

Retrieve a single webhook entry by id

GET

https://partner-api.monta.com

/api/v1/webhooks/entries/{entryId}

This endpoint returns a single entry by id. Note that we only persist entries for past 24 hours. Required scope: webhooks:read

Retrieve a single webhook entry by id › path Parameters

entryId

integer · int64 · required

Retrieve a single webhook entry by id › Responses

Webhook entry with given id

WebhookEntry

eventType

string · enum · required

Code
        Type of event this entry belongs to.
        Note: This is not the type of the entity (payload.EntityType), but the type of the event that you can subscribe to.

Enum values:

charges

charge-points

sites

users

team-members

teams

installer-jobs

wallet-transactions

Example: charge-points

object · required

payload of this entry

Example: See [Charge](/reference/get-charge) payload

status

string · enum · required

Status of the entry

Enum values:

pending

completed

failed

Example: completed

createdAt

string · date-time · required

Creation date of this entry

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

id

integer · int64

Id of the entry

Example: 1

consumerId

integer · int64

Id of the consumer this entry belongs to

Example: 1

operatorId

integer · int64

Id of the operator this entry belongs to

Example: 1

object

Contains the error message if the delivery failed

Example: {"errorCode":"500","errorMessage":"Bad Gateway: The server is unreachable at this time."}

updatedAt

string | null · date-time

Update date of this entry

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

Endpoint to generate and explain signature details

POST

https://partner-api.monta.com

/api/v1/webhooks/get-signature-detail

Required scope: manage-webhooks:read.
Note that this endpoint is only for debugging purposes, is not stable and should not be used in production.
Read more here: https://docs.partner-api.monta.com/reference/generating-the-signature-example.

Endpoint to generate and explain signature details › query Parameters

includeSecrets

boolean

If set to true, the secrets used to sign the payload will be included in the response.

Default: false

webhookSecret

string

If provided, webhookSecret will be used instead of your actual secret.

Endpoint to generate and explain signature details › Request Body

Endpoint to generate and explain signature details › Responses

Debug output to explain signature based on your payload.

SignatureExplanation

receivedPayloadString

string · required

The processed payload as string

receivedPayloadBytes

string · required

The processed payload as bytes (hex)

webhookSecret

string · required

The secret used to sign the payload

webhookSecretBytes

string · required

The secret used to sign the payload as bytes (hex)

signatureAlgorithm

string · required

The algorithm used for generating the signature

signature

string · required

The resulting signature

signatureWithPrefix

string · required

The resulting signature including prefix

Wallets