Our “Burger Service” Webhook Management API provides endpoints to create, retrieve, ingest, trigger, and update webhooks (as well as their invocations), enabling streamlined event-driven integrations.
Our “Burger Service” Webhook Management API provides endpoints to create, retrieve, ingest, trigger, and update webhooks (as well as their invocations), enabling streamlined event-driven integrations.
The ID identifying the profile to use for this request. This is required for multi-tenancy use cases if the different profiles of a single customer are served by the shared cresta-api but have not been migrated to a single DB yet. (-- api-linter: core::0131::request-unknown-fields=disabled --).
curl -i -X GET \
'https://{api-domain}.cresta.com/v1/{name=customers/*/profiles/*/webhooks/*/invocations/*}'
{ "webhookInvocation": { "name": "string", "requestUri": "string", "payload": "string", "executionDuration": "string", "resolveTime": "2019-08-24T14:15:22Z", "resolvedByInvocation": "string", "done": true, "error": { … }, "resultStatusDetails": "string", "createTime": "2019-08-24T14:15:22Z", "updateTime": "2019-08-24T14:15:22Z" } }
The ID identifying the profile to use for this request. This is required for multi-tenancy use cases if the different profiles of a single customer are served by the shared cresta-api but have not been migrated to a single DB yet. (-- api-linter: core::0131::request-unknown-fields=disabled --).
curl -i -X GET \
'https://{api-domain}.cresta.com/v1/{name=customers/*/profiles/*/webhooks/*}'
{ "webhook": { "name": "string", "displayName": "string", "context": "CONTEXT_UNSPECIFIED", "webhookType": "WEBHOOK_TYPE_UNSPECIFIED", "state": "STATE_UNSPECIFIED", "incomingWebhookConfig": { … }, "outgoingWebhookConfig": { … }, "createTime": "2019-08-24T14:15:22Z", "updateTime": "2019-08-24T14:15:22Z", "creator": "string", "lastEditor": "string" } }
curl -i -X POST \
'https://{api-domain}.cresta.com/v1/{name=customers/*/profiles/*/webhooks/*}:ingest' \
-H 'Content-Type: application/json' \
-d '{}'
{ "invocation": "string" }
curl -i -X POST \
'https://{api-domain}.cresta.com/v1/{name=customers/*/profiles/*/webhooks/*}:trigger' \
-H 'Content-Type: application/json' \
-d '{
"triggerSource": "string",
"conversationName": "string",
"profileId": "string"
}'
{ "invocation": "string" }
The ID identifying the profile to use for this request. This is required for multi-tenancy use cases if the different profiles of a single customer are served by the shared cresta-api but have not been migrated to a single DB yet. (-- api-linter: core::0131::request-unknown-fields=disabled --).
curl -i -X GET \
'https://{api-domain}.cresta.com/v1/{name=customers/*/webhooks/*/invocations/*}'
{ "webhookInvocation": { "name": "string", "requestUri": "string", "payload": "string", "executionDuration": "string", "resolveTime": "2019-08-24T14:15:22Z", "resolvedByInvocation": "string", "done": true, "error": { … }, "resultStatusDetails": "string", "createTime": "2019-08-24T14:15:22Z", "updateTime": "2019-08-24T14:15:22Z" } }
The ID identifying the profile to use for this request. This is required for multi-tenancy use cases if the different profiles of a single customer are served by the shared cresta-api but have not been migrated to a single DB yet. (-- api-linter: core::0131::request-unknown-fields=disabled --).
curl -i -X GET \
'https://{api-domain}.cresta.com/v1/{name=customers/*/webhooks/*}'
{ "webhook": { "name": "string", "displayName": "string", "context": "CONTEXT_UNSPECIFIED", "webhookType": "WEBHOOK_TYPE_UNSPECIFIED", "state": "STATE_UNSPECIFIED", "incomingWebhookConfig": { … }, "outgoingWebhookConfig": { … }, "createTime": "2019-08-24T14:15:22Z", "updateTime": "2019-08-24T14:15:22Z", "creator": "string", "lastEditor": "string" } }
curl -i -X POST \
'https://{api-domain}.cresta.com/v1/{name=customers/*/webhooks/*}:ingest' \
-H 'Content-Type: application/json' \
-d '{}'
{ "invocation": "string" }
curl -i -X POST \
'https://{api-domain}.cresta.com/v1/{name=customers/*/webhooks/*}:trigger' \
-H 'Content-Type: application/json' \
-d '{
"triggerSource": "string",
"conversationName": "string",
"profileId": "string"
}'
{ "invocation": "string" }
The maximum number of webhook invocations to return. If unspecified, at most 50 will be returned. Ordered by creation date.
A page token, received from a previous ListWebhookInvocations
call. Provide this to retrieve the subsequent page.
Invocation status to filter by (OR combined).
The ID identifying the profile to use for this request. This is required for multi-tenancy use cases if the different profiles of a single customer are served by the shared cresta-api but have not been migrated to a single DB yet. (-- api-linter: core::0131::request-unknown-fields=disabled --).
curl -i -X GET \
'https://{api-domain}.cresta.com/v1/{parent=customers/*/profiles/*/webhooks/*}/invocations'
{ "webhookInvocations": [ { … } ], "nextPageToken": "string" }
The maximum number of webhooks to return. If unspecified, at most 50 will be returned.
A page token, received from a previous ListWebhooks
call. Provide this to retrieve the subsequent page.
The ID identifying the profile to use for this request. This is required for multi-tenancy use cases if the different profiles of a single customer are served by the shared cresta-api but have not been migrated to a single DB yet. (-- api-linter: core::0131::request-unknown-fields=disabled --).
curl -i -X GET \
'https://{api-domain}.cresta.com/v1/{parent=customers/*/profiles/*}/webhooks'
{ "webhooks": [ { … } ], "nextPageToken": "string" }
The ID identifying the profile to use for this request. This is required for multi-tenancy use cases if the different profiles of a single customer are served by the shared cresta-api but have not been migrated to a single DB yet. (-- api-linter: core::0133::request-unknown-fields=disabled --).
The webhook to be created.
The available context types for a webhook.
curl -i -X POST \
'https://{api-domain}.cresta.com/v1/{parent=customers/*/profiles/*}/webhooks/{webhookId}' \
-H 'Content-Type: application/json' \
-d '{
"name": "string",
"displayName": "string",
"context": "CONTEXT_UNSPECIFIED",
"webhookType": "WEBHOOK_TYPE_UNSPECIFIED",
"state": "STATE_UNSPECIFIED",
"incomingWebhookConfig": {
"resourceNameJsonPath": "string",
"externalIdJsonPath": "string",
"fieldMapping": [
{
"fromJsonPath": "string",
"toMetadataTaxonomy": "string"
}
],
"basicAuthentication": {
"username": "string",
"password": "string"
},
"ignoreMissingResource": true
},
"outgoingWebhookConfig": {
"uri": "string",
"method": "string",
"basic": {
"username": "string",
"password": "string"
},
"bearer": {
"token": "string"
},
"oauth2": {
"grantType": "OAUTH2_GRANT_TYPE_UNSPECIFIED",
"jwtParameters": {
"iss": "string",
"aud": "string",
"sub": "string",
"otherInputClaims": {
"property1": "string",
"property2": "string"
},
"privateKey": "string"
},
"clientCredentialParameters": {
"clientId": "string",
"clientSecret": "string"
},
"passwordCredentialsParameters": {
"username": "string",
"password": "string",
"clientId": "string",
"clientSecret": "string"
},
"scope": "string",
"accessTokenUri": "string",
"authStyle": "AUTH_STYLE_UNSPECIFIED",
"doNotFormUrlencodeBasicAuth": true
},
"headers": [
{
"name": "string",
"value": "string",
"type": "HEADER_TYPE_UNSPECIFIED"
}
],
"body": "string",
"bodySyntaxVersion": 0,
"retryOptions": {
"maxRetries": 0,
"minRetryWait": "string",
"maxRetryWait": "string",
"timeout": "string",
"retryStatusCodes": [
0
]
}
}
}'
{ "webhook": { "name": "string", "displayName": "string", "context": "CONTEXT_UNSPECIFIED", "webhookType": "WEBHOOK_TYPE_UNSPECIFIED", "state": "STATE_UNSPECIFIED", "incomingWebhookConfig": { … }, "outgoingWebhookConfig": { … }, "createTime": "2019-08-24T14:15:22Z", "updateTime": "2019-08-24T14:15:22Z", "creator": "string", "lastEditor": "string" } }
The maximum number of webhook invocations to return. If unspecified, at most 50 will be returned. Ordered by creation date.
A page token, received from a previous ListWebhookInvocations
call. Provide this to retrieve the subsequent page.
Invocation status to filter by (OR combined).
The ID identifying the profile to use for this request. This is required for multi-tenancy use cases if the different profiles of a single customer are served by the shared cresta-api but have not been migrated to a single DB yet. (-- api-linter: core::0131::request-unknown-fields=disabled --).
curl -i -X GET \
'https://{api-domain}.cresta.com/v1/{parent=customers/*/webhooks/*}/invocations'
{ "webhookInvocations": [ { … } ], "nextPageToken": "string" }
The maximum number of webhooks to return. If unspecified, at most 50 will be returned.
A page token, received from a previous ListWebhooks
call. Provide this to retrieve the subsequent page.
The ID identifying the profile to use for this request. This is required for multi-tenancy use cases if the different profiles of a single customer are served by the shared cresta-api but have not been migrated to a single DB yet. (-- api-linter: core::0131::request-unknown-fields=disabled --).
curl -i -X GET \
'https://{api-domain}.cresta.com/v1/{parent=customers/*}/webhooks'
{ "webhooks": [ { … } ], "nextPageToken": "string" }
The ID identifying the profile to use for this request. This is required for multi-tenancy use cases if the different profiles of a single customer are served by the shared cresta-api but have not been migrated to a single DB yet. (-- api-linter: core::0133::request-unknown-fields=disabled --).
The webhook to be created.
The available context types for a webhook.
curl -i -X POST \
'https://{api-domain}.cresta.com/v1/{parent=customers/*}/webhooks/{webhookId}' \
-H 'Content-Type: application/json' \
-d '{
"name": "string",
"displayName": "string",
"context": "CONTEXT_UNSPECIFIED",
"webhookType": "WEBHOOK_TYPE_UNSPECIFIED",
"state": "STATE_UNSPECIFIED",
"incomingWebhookConfig": {
"resourceNameJsonPath": "string",
"externalIdJsonPath": "string",
"fieldMapping": [
{
"fromJsonPath": "string",
"toMetadataTaxonomy": "string"
}
],
"basicAuthentication": {
"username": "string",
"password": "string"
},
"ignoreMissingResource": true
},
"outgoingWebhookConfig": {
"uri": "string",
"method": "string",
"basic": {
"username": "string",
"password": "string"
},
"bearer": {
"token": "string"
},
"oauth2": {
"grantType": "OAUTH2_GRANT_TYPE_UNSPECIFIED",
"jwtParameters": {
"iss": "string",
"aud": "string",
"sub": "string",
"otherInputClaims": {
"property1": "string",
"property2": "string"
},
"privateKey": "string"
},
"clientCredentialParameters": {
"clientId": "string",
"clientSecret": "string"
},
"passwordCredentialsParameters": {
"username": "string",
"password": "string",
"clientId": "string",
"clientSecret": "string"
},
"scope": "string",
"accessTokenUri": "string",
"authStyle": "AUTH_STYLE_UNSPECIFIED",
"doNotFormUrlencodeBasicAuth": true
},
"headers": [
{
"name": "string",
"value": "string",
"type": "HEADER_TYPE_UNSPECIFIED"
}
],
"body": "string",
"bodySyntaxVersion": 0,
"retryOptions": {
"maxRetries": 0,
"minRetryWait": "string",
"maxRetryWait": "string",
"timeout": "string",
"retryStatusCodes": [
0
]
}
}
}'
{ "webhook": { "name": "string", "displayName": "string", "context": "CONTEXT_UNSPECIFIED", "webhookType": "WEBHOOK_TYPE_UNSPECIFIED", "state": "STATE_UNSPECIFIED", "incomingWebhookConfig": { … }, "outgoingWebhookConfig": { … }, "createTime": "2019-08-24T14:15:22Z", "updateTime": "2019-08-24T14:15:22Z", "creator": "string", "lastEditor": "string" } }
curl -i -X PATCH \
'https://{api-domain}.cresta.com/v1/{webhook.name=customers/*/profiles/*/webhooks/*}' \
-H 'Content-Type: application/json' \
-d '{
"webhook": {
"name": "string",
"displayName": "string",
"context": "CONTEXT_UNSPECIFIED",
"webhookType": "WEBHOOK_TYPE_UNSPECIFIED",
"state": "STATE_UNSPECIFIED",
"incomingWebhookConfig": {
"resourceNameJsonPath": "string",
"externalIdJsonPath": "string",
"fieldMapping": [
{
"fromJsonPath": "string",
"toMetadataTaxonomy": "string"
}
],
"basicAuthentication": {
"username": "string",
"password": "string"
},
"ignoreMissingResource": true
},
"outgoingWebhookConfig": {
"uri": "string",
"method": "string",
"basic": {
"username": "string",
"password": "string"
},
"bearer": {
"token": "string"
},
"oauth2": {
"grantType": "OAUTH2_GRANT_TYPE_UNSPECIFIED",
"jwtParameters": {
"iss": "string",
"aud": "string",
"sub": "string",
"otherInputClaims": {
"property1": "string",
"property2": "string"
},
"privateKey": "string"
},
"clientCredentialParameters": {
"clientId": "string",
"clientSecret": "string"
},
"passwordCredentialsParameters": {
"username": "string",
"password": "string",
"clientId": "string",
"clientSecret": "string"
},
"scope": "string",
"accessTokenUri": "string",
"authStyle": "AUTH_STYLE_UNSPECIFIED",
"doNotFormUrlencodeBasicAuth": true
},
"headers": [
{
"name": "string",
"value": "string",
"type": "HEADER_TYPE_UNSPECIFIED"
}
],
"body": "string",
"bodySyntaxVersion": 0,
"retryOptions": {
"maxRetries": 0,
"minRetryWait": "string",
"maxRetryWait": "string",
"timeout": "string",
"retryStatusCodes": [
0
]
}
}
},
"profileId": "string"
}'
{ "webhook": { "name": "string", "displayName": "string", "context": "CONTEXT_UNSPECIFIED", "webhookType": "WEBHOOK_TYPE_UNSPECIFIED", "state": "STATE_UNSPECIFIED", "incomingWebhookConfig": { … }, "outgoingWebhookConfig": { … }, "createTime": "2019-08-24T14:15:22Z", "updateTime": "2019-08-24T14:15:22Z", "creator": "string", "lastEditor": "string" } }