Webhooks

The Webhooks feature allows you to configure endpoints on your server to receive real-time event notifications from our system. By setting up a webhook, you can automate workflows, track updates, or respond to specific events programmatically.

GET List of webhooks

PUT Create/Update webhook

DELETE Delete your webhook

Retrieves webhooks list

get

Retrieves your configured webhooks list

Authorizations
Header parameters
x-api-keystringRequired

Your credential's unique identifier key

x-pvt-timezonestringOptional

Your timezone

Responses
200
List of your configured webhooks
application/json
get
GET /business/v1/settings/webhooks HTTP/1.1
Host: api.mio.id
Authorization: Bearer JWT
x-api-key: text
Accept: */*

[
  {
    "type": "ACTIVITY_EVENT",
    "url": "https://www.mycompanyhost.com/my-webhook",
    "secret": "my-32-bytes-sized-secret",
    "authorization": {
      "type": "BASIC_AUTH",
      "value": {
        "username": "my-user-name",
        "password": "my-secure-password"
      }
    },
    "headers": {
      "Content-Type": "application/json"
    }
  }
]

Creates a new or updates an existent webhook

put

Creates a new or updates an existent webhook for integration

Authorizations
Header parameters
x-api-keystringRequired

Your credential's unique identifier key

x-pvt-timezonestringOptional

Your timezone

Body
typestring · enumRequiredExample: ACTIVITY_EVENTPossible values:
urlstringRequiredExample: https://www.mycompanyhost.com/my-webhook
secretstringOptionalExample: my-32-bytes-sized-secret
headersobjectOptionalExample: {"Content-Type":"application/json"}
Responses
204
Your webhook has been created or updated on your configurations successfully
put
PUT /business/v1/settings/webhooks HTTP/1.1
Host: api.mio.id
Authorization: Bearer JWT
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 262

{
  "type": "ACTIVITY_EVENT",
  "url": "https://www.mycompanyhost.com/my-webhook",
  "secret": "my-32-bytes-sized-secret",
  "authorization": {
    "type": "BASIC_AUTH",
    "value": {
      "username": "my-user-name",
      "password": "my-secure-password"
    }
  },
  "headers": {
    "Content-Type": "application/json"
  }
}
No content

Deletes your configured webhook

delete

Removes from your webhook list the item for the specified ID

Authorizations
Path parameters
idstringRequiredExample: my-webhook-id
Header parameters
x-api-keystringRequired

Your credential's unique identifier key

x-pvt-timezonestringOptional

Your timezone

Responses
204
Your webhook has been removed from your configurations successfully
delete
DELETE /business/v1/settings/webhooks/{id} HTTP/1.1
Host: api.mio.id
Authorization: Bearer JWT
x-api-key: text
Accept: */*

No content

Last updated