IntegrationDestinations

Create Webhook Destination

Changed on Oct 16, 2026

This endpoint creates a new webhook destination. A webhook destination is a URL where webhook payloads will be sent.

post/organizations/{orgId}/integrationdestinations/webhooks

Request

Base URL
https://api.m3ter.com
Auth
OAuth 2
Authorization codehttps://m3ter.auth.us-east-1.amazoncognito.com/oauth2/authorize, token URL https://m3ter.auth.us-east-1.amazoncognito.com/oauth2/token
Client credentialsToken URL /oauth/token
TypeScript
https://skmtc.dev/m3ter-com/apis/m3ter-api/docs/organizations/:orgId/integrationdestinations/webhooks/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

orgIdstring required

The unique identifier (UUID) for the organization. This specifies the organization within which the webhook destination is created.

Request body

urlstring required

The URL to which the webhook requests will be sent.

versioninteger

The version number of the entity:

Create entity: Not valid for initial insertion of new entity - do not use for Create. On initial Create, version is set at 1 and listed in the response.
Update Entity: On Update, version is required and must match the existing version because a check is performed to ensure sequential versioning is preserved. Version is incremented by 1 and listed in the response.

namestring required

descriptionstring required

codestring

activeboolean

Example request

{
  "credentials": {
    "name": "Integration Credentials",
    "apiKey": "api key",
    "secret": "api secret"
  }
}

Response

Returns the DestinationCreateRequest

urlstring

The URL to which webhook requests are sent.

idstring required

The UUID of the entity.

versioninteger

The version number:

Create: On initial Create to insert a new entity, the version is set at 1 in the response.
Update: On successful Update, the version is incremented by 1 in the response.

dtCreatedstring date-time

The DateTime when this item was created (in ISO-8601 format).

dtLastModifiedstring date-time

The DateTime when this item was last modified (in ISO-8601 format).

createdBystring

The ID of the user who created this item.

lastModifiedBystring

The ID of the user who last modified this item.

namestring

descriptionstring