GRgrepr
Webhook Integration

Create a webhook integration

Creates a webhook integration. Senders POST events to /v1/integrations/webhooks/{id}/events and authenticate with a Grepr API key (GREPR-API-KEY header).

post/v1/integrations/webhooks

Request

  • Base URL
    https://docs.grepr.ai (the document declares no server; this is the origin it was published from)
  • Auth
    • API key in header GREPR-API-KEY
    • or OpenID Connect (https://grepr-prod.us.auth0.com/.well-known/openid-configuration)

Request body

namestring required

Name of the integration.

teamIdsstring[]

The team IDs that this integration is associated with.

type'webhook' required

The type of the integration. This is used to determine the payload type.

versioninteger required

Version of the integration. Should be increased by one for every new update in order for the write to succeed. Otherwise, a '409 Conflict' will be returned.

Example request

{
  "name": "my_integration"
}

Response

Integration created successfully

createdAtstring date-time required

Timestamp when the integration was created.

idstring required

The integration id

jobIdsstring[] required

List of job IDs associated with the integration.

namestring required

Name of the integration.

organizationIdstring required

Organization ID of the integration.

teamIdsstring[]

The team IDs that this integration is associated with.

type'webhook' required

The type of the integration. This is used to determine the payload type.

updatedAtstring date-time required

Timestamp when the integration was last updated.

versioninteger required

Version of the integration. Should be increased by one for every new update in order for the write to succeed. Otherwise, a '409 Conflict' will be returned.

Example response

{
  "name": "my_integration"
}

Changes

No recorded changes to this operation across all 1 revision of this API.