What the trigger fires on — one or more kind ids from GET /triggers/kinds, or a single id as shorthand. Kinds come in two families: connector data kinds (e.g. email, calendar_event) that fire on events from your connected accounts, and entity kinds (e.g. person, organization) that fire when an extracted entity of that type changes. Use '*' to match every kind.
Which change to fire on. created/updated/deleted are lifecycle changes to the underlying record. observed fires whenever an entity of the given kind is seen in evidence, even if nothing about it changed — useful for entity kinds. '*' matches any action.
Optional predicate for deeper rules — narrow the trigger beyond kind + action by matching against fields on the event payload. A leaf clause is {"field": "<dotted.path>", "op": "<operator>", "value": ...}; operators are eq, ne, exists, contains, starts_with, ends_with, regex, in, includes, domain_matches, and gt/lt/gte/lte. Clauses compose via all / any / not, nested to any depth. The fields you can reference are listed on each kind's predicate_fields in GET /triggers/kinds. For entity kinds with action: observed, filter on entity_urn — exists fires only for observations that resolved to a known entity, eq scopes to one specific entity — or on via (identity = structured field like a sender or attendee, content = name found in body text). The predicate can be at most 16,384 bytes when serialized as JSON.
For observed-action triggers on entity kinds, also match name variants and minor misspellings — not just exact aliases. Ignored on other kinds and actions.
Webhook signing secret, returned only in the create response — store it. Each delivery carries an 'Adapter-Signature: v1=' header; verify it by computing HMAC-SHA256 over '.' with this secret and comparing hex digests. Reject deliveries whose timestamp is older than your replay window.
Consecutive events that failed to deliver, counted once per event after its final retry. Resets to 0 on success. At 50 the trigger is disabled automatically.
Set when the trigger was disabled automatically after 50 consecutive events failed to deliver. Fix your endpoint, then update the trigger with enabled=true to resume.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Adapter","colors":{"primary":"#8765F0","light":"#8765F0","dark":"#8765F0"},"logo":{"light":"https://mintcdn.com/adapter/J3Ydy4fSe61BUDTE/logo/light.svg?fit=max\u0026auto=format\u0026n=J3Ydy4fSe61BUDTE\u0026q=85\u0026s=459bd6410eb825d264414176cd7eba07","dark":"https://mintcdn.com/adapter/J3Ydy4fSe61BUDTE/logo/dark.svg?fit=max\u0026auto=format\u0026n=J3Ydy4fSe61BUDTE\u0026q=85\u0026s=0bed0f3d3311b99106ba98e43a63d5e2"},"favicon":"https://mintcdn.com/adapter/J3Ydy4fSe61BUDTE/favicon.svg?fit=max\u0026auto=format\u0026n=J3Ydy4fSe61BUDTE\u0026q=85\u0026s=83406b22c16edb6994e5b28b146a7446","api":{"openapi":"api-reference/openapi.json","playground":{}},"background":{"color":{"light":"#F2F2F0","dark":"#171717"}},"navbar":{"links":[{"href":"mailto:support@adapter.com","label":"Support"}],"primary":{"type":"button","label":"Sign In","href":"https://mind.adapter.com"}},"footer":{"socials":{"x":"https://x.com/adapter"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"adapter","hasAudioNarration":false,"actualSubdomain":"adapter","customDomains":["docs.beta.adapter.com"],"gitSource":{"type":"github","owner":"adapter-group","repo":"adapter-platform","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae23bb95db1d64f77da812c","collectionId":"3e863929-e534-43f8-bffd-cc13d5f5a900","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae23bb95db1d64f77da812c"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae23bb95db1d64f77da812c","clientVersion":"0.0.4043","searchFilterCounts":[{"language":"default","tag":"API Reference","count":40},{"language":"default","tag":"Documentation","count":13},{"language":"default","tag":"Knowledge","count":11},{"language":"default","tag":"Triggers","count":10},{"language":"default","tag":"Core Concepts","count":7},{"language":"default","tag":"Ingestion","count":6},{"language":"default","tag":"Custom Connectors","count":5},{"language":"default","tag":"Getting Started","count":4},{"language":"default","tag":"Connectors","count":3},{"language":"default","tag":"Data","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/Triggers/create-trigger","slug":"/api-reference/Triggers/create-trigger","pageMetadata":{"title":"Create trigger","openapi":"POST /v1/triggers","description":null,"href":"/api-reference/Triggers/create-trigger"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{children:`\n`})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create trigger","openapi":"POST /v1/triggers","description":null,"href":"/api-reference/Triggers/create-trigger"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Triggers"],"summary":"Create trigger","operationId":"create_trigger","requestBody":"db3194a9-b379-4cc8-92b5-53c4faee937e","responses":{"201":"888d80ae-342d-4767-8b13-e7dad8e5f175","401":"f05955ca-1773-4850-b4e9-2c47ae122bfc","403":"8860ed26-f887-45fb-851d-0c38ff9b94cb","409":"1fea3f98-15a2-4f13-b752-64c5b5bbe9b9","422":"01699e80-2b70-4d67-9394-53ed9da3b42c","500":"b8168dce-118a-4b85-bac3-500dd44f5848"},"method":"post","type":"path","servers":["b45a6dfc-eec4-42ae-a72a-9361a1098054"],"security":[],"path":"/v1/triggers","baseUrlOptions":["http://localhost:8080"],"title":"Create trigger","description":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"properties":{"kind":{"oneOf":[{"type":"string","title":"Kind","description":"What the trigger fires on — one or more kind ids from `GET /triggers/kinds`, or a single id as shorthand. Kinds come in two families: **connector data** kinds (e.g. `email`, `calendar_event`) that fire on events from your connected accounts, and **entity** kinds (e.g. `person`, `organization`) that fire when an extracted entity of that type changes. Use `'*'` to match every kind.","example":["email","calendar_event"],"isRequired":true,"uniqueKey":"kind.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"kind.oneOf.1.items.[INDEX]","typeLabel":"string"},"title":"Kind","description":"What the trigger fires on — one or more kind ids from `GET /triggers/kinds`, or a single id as shorthand. Kinds come in two families: **connector data** kinds (e.g. `email`, `calendar_event`) that fire on events from your connected accounts, and **entity** kinds (e.g. `person`, `organization`) that fire when an extracted entity of that type changes. Use `'*'` to match every kind.","example":["email","calendar_event"],"isRequired":true,"uniqueKey":"kind.oneOf.1","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"kind","typeLabel":"string | string[]"},"action":{"type":"string","enum":["observed","created","updated","deleted","*"],"title":"Action","description":"Which change to fire on. `created`/`updated`/`deleted` are lifecycle changes to the underlying record. `observed` fires whenever an entity of the given kind is seen in evidence, even if nothing about it changed — useful for entity kinds. `'*'` matches any action.","isRequired":true,"uniqueKey":"action","typeLabel":"enum\u003cstring>"},"delivery":{"properties":{"url":{"type":"string","maxLength":2048,"title":"Url","description":"Target URL to POST events to. Must be https on port 443 or 8443, at most 2048 characters.","examples":["https://example.com/hooks/adapter"],"isRequired":true,"uniqueKey":"delivery.url","typeLabel":"string"},"kind":{"type":"string","const":"webhook","title":"Kind","default":"webhook","uniqueKey":"delivery.kind","typeLabel":"string"}},"type":"object","required":["url"],"title":"WebhookDelivery","isRequired":true,"uniqueKey":"delivery","typeLabel":"WebhookDelivery · object"},"name":{"oneOf":[{"type":"string","title":"Name","description":"Optional display name to tell your triggers apart in lists and the console. Purely cosmetic — it has no effect on matching or delivery.","maxLength":128,"minLength":1,"example":"New-hire emails from recruiting","uniqueKey":"name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Name","description":"Optional display name to tell your triggers apart in lists and the console. Purely cosmetic — it has no effect on matching or delivery.","example":"New-hire emails from recruiting","uniqueKey":"name.oneOf.1","typeLabel":"null"}],"uniqueKey":"name","typeLabel":"string | null"},"filter":{"oneOf":[{"type":"object","title":"Filter","description":"Optional predicate for deeper rules — narrow the trigger beyond kind + action by matching against fields on the event payload. A leaf clause is `{\"field\": \"\u003cdotted.path>\", \"op\": \"\u003coperator>\", \"value\": ...}`; operators are `eq`, `ne`, `exists`, `contains`, `starts_with`, `ends_with`, `regex`, `in`, `includes`, `domain_matches`, and `gt`/`lt`/`gte`/`lte`. Clauses compose via `all` / `any` / `not`, nested to any depth. The fields you can reference are listed on each kind's `predicate_fields` in `GET /triggers/kinds`. For entity kinds with `action: observed`, filter on `entity_urn` — `exists` fires only for observations that resolved to a known entity, `eq` scopes to one specific entity — or on `via` (`identity` = structured field like a sender or attendee, `content` = name found in body text). The predicate can be at most 16,384 bytes when serialized as JSON.","example":{"field":"entity_urn","op":"exists"},"additionalProperties":true,"uniqueKey":"filter.oneOf.0","typeLabel":"Filter · object"},{"type":"null","title":"Filter","description":"Optional predicate for deeper rules — narrow the trigger beyond kind + action by matching against fields on the event payload. A leaf clause is `{\"field\": \"\u003cdotted.path>\", \"op\": \"\u003coperator>\", \"value\": ...}`; operators are `eq`, `ne`, `exists`, `contains`, `starts_with`, `ends_with`, `regex`, `in`, `includes`, `domain_matches`, and `gt`/`lt`/`gte`/`lte`. Clauses compose via `all` / `any` / `not`, nested to any depth. The fields you can reference are listed on each kind's `predicate_fields` in `GET /triggers/kinds`. For entity kinds with `action: observed`, filter on `entity_urn` — `exists` fires only for observations that resolved to a known entity, `eq` scopes to one specific entity — or on `via` (`identity` = structured field like a sender or attendee, `content` = name found in body text). The predicate can be at most 16,384 bytes when serialized as JSON.","example":{"field":"entity_urn","op":"exists"},"uniqueKey":"filter.oneOf.1","typeLabel":"null"}],"uniqueKey":"filter","typeLabel":"Filter · object | null"},"entity_observation_fuzzy":{"type":"boolean","title":"Entity Observation Fuzzy","description":"For `observed`-action triggers on entity kinds, also match name variants and minor misspellings — not just exact aliases. Ignored on other kinds and actions.","default":false,"uniqueKey":"entity_observation_fuzzy","typeLabel":"boolean"},"enabled":{"type":"boolean","title":"Enabled","default":true,"uniqueKey":"enabled","typeLabel":"boolean"}},"type":"object","required":["kind","action","delivery"],"title":"TriggerCreateRequest","uniqueKey":"","typeLabel":"TriggerCreateRequest · object"},"examples":{"Example":{"title":"Example","value":{"kind":["email","calendar_event"],"delivery":{"url":"https://example.com/hooks/adapter","kind":"webhook"},"name":"New-hire emails from recruiting","filter":{"field":"entity_urn","op":"exists"},"entity_observation_fuzzy":false,"enabled":true}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"888d80ae-342d-4767-8b13-e7dad8e5f175":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"id":{"type":"string","title":"Id","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"user_id":{"type":"string","title":"User Id","isRequired":true,"uniqueKey":"user_id","typeLabel":"string"},"kind":{"items":{"type":"string","uniqueKey":"kind.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Kind","description":"Kind ids this trigger fires for; ['*'] means any kind.","isRequired":true,"uniqueKey":"kind","typeLabel":"string[]"},"action":{"type":"string","title":"Action","isRequired":true,"uniqueKey":"action","typeLabel":"string"},"delivery":{"additionalProperties":true,"type":"object","title":"Delivery","isRequired":true,"uniqueKey":"delivery","typeLabel":"Delivery · object"},"enabled":{"type":"boolean","title":"Enabled","isRequired":true,"uniqueKey":"enabled","typeLabel":"boolean"},"name":{"oneOf":[{"type":"string","title":"Name","description":"Display name, if you set one.","uniqueKey":"name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Name","description":"Display name, if you set one.","uniqueKey":"name.oneOf.1","typeLabel":"null"}],"uniqueKey":"name","typeLabel":"string | null"},"filter":{"oneOf":[{"type":"object","title":"Filter","additionalProperties":true,"uniqueKey":"filter.oneOf.0","typeLabel":"Filter · object"},{"type":"null","title":"Filter","uniqueKey":"filter.oneOf.1","typeLabel":"null"}],"uniqueKey":"filter","typeLabel":"Filter · object | null"},"entity_observation_fuzzy":{"type":"boolean","title":"Entity Observation Fuzzy","description":"Whether fuzzy-matched entity observations are accepted in addition to exact matches.","default":false,"uniqueKey":"entity_observation_fuzzy","typeLabel":"boolean"},"secret":{"oneOf":[{"type":"string","title":"Secret","description":"Webhook signing secret, returned only in the create response — store it. Each delivery carries an 'Adapter-Signature: v1=\u003chex>' header; verify it by computing HMAC-SHA256 over '\u003cAdapter-Timestamp header>.\u003craw request body>' with this secret and comparing hex digests. Reject deliveries whose timestamp is older than your replay window.","uniqueKey":"secret.oneOf.0","typeLabel":"string"},{"type":"null","title":"Secret","description":"Webhook signing secret, returned only in the create response — store it. Each delivery carries an 'Adapter-Signature: v1=\u003chex>' header; verify it by computing HMAC-SHA256 over '\u003cAdapter-Timestamp header>.\u003craw request body>' with this secret and comparing hex digests. Reject deliveries whose timestamp is older than your replay window.","uniqueKey":"secret.oneOf.1","typeLabel":"null"}],"uniqueKey":"secret","typeLabel":"string | null"},"created_at":{"oneOf":[{"type":"string","title":"Created At","format":"date-time","uniqueKey":"created_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Created At","uniqueKey":"created_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"created_at","typeLabel":"string\u003cdate-time> | null"},"updated_at":{"oneOf":[{"type":"string","title":"Updated At","format":"date-time","uniqueKey":"updated_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Updated At","uniqueKey":"updated_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"updated_at","typeLabel":"string\u003cdate-time> | null"},"last_fired_at":{"oneOf":[{"type":"string","title":"Last Fired At","description":"When this trigger last matched an event and delivery was attempted, including failed deliveries.","format":"date-time","uniqueKey":"last_fired_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Last Fired At","description":"When this trigger last matched an event and delivery was attempted, including failed deliveries.","uniqueKey":"last_fired_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"last_fired_at","typeLabel":"string\u003cdate-time> | null"},"last_status":{"oneOf":[{"type":"string","title":"Last Status","description":"Outcome of your most recent delivery. Null until the trigger first fires.","enum":["delivered","failed"],"uniqueKey":"last_status.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Last Status","description":"Outcome of your most recent delivery. Null until the trigger first fires.","uniqueKey":"last_status.oneOf.1","typeLabel":"null"}],"uniqueKey":"last_status","typeLabel":"enum\u003cstring> | null"},"consecutive_failures":{"type":"integer","title":"Consecutive Failures","description":"Consecutive events that failed to deliver, counted once per event after its final retry. Resets to 0 on success. At 50 the trigger is disabled automatically.","default":0,"uniqueKey":"consecutive_failures","typeLabel":"integer"},"auto_disabled_at":{"oneOf":[{"type":"string","title":"Auto Disabled At","description":"Set when the trigger was disabled automatically after 50 consecutive events failed to deliver. Fix your endpoint, then update the trigger with enabled=true to resume.","format":"date-time","uniqueKey":"auto_disabled_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Auto Disabled At","description":"Set when the trigger was disabled automatically after 50 consecutive events failed to deliver. Fix your endpoint, then update the trigger with enabled=true to resume.","uniqueKey":"auto_disabled_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"auto_disabled_at","typeLabel":"string\u003cdate-time> | null"}},"type":"object","required":["id","user_id","kind","action","delivery","enabled"],"title":"TriggerResponse","uniqueKey":"","typeLabel":"TriggerResponse · object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","user_id":"\u003cstring>","kind":["\u003cstring>"],"action":"\u003cstring>","delivery":{},"enabled":true,"name":"\u003cstring>","filter":{},"entity_observation_fuzzy":false,"secret":"\u003cstring>","created_at":"2023-11-07T05:31:56Z","updated_at":"2023-11-07T05:31:56Z","last_fired_at":"2023-11-07T05:31:56Z","last_status":"delivered","consecutive_failures":0,"auto_disabled_at":"2023-11-07T05:31:56Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"f05955ca-1773-4850-b4e9-2c47ae122bfc":{"content":{"application/json":{"schema":{"properties":{"error_code":{"type":"string","const":"authentication_error","title":"Error Code","default":"authentication_error","uniqueKey":"error_code","typeLabel":"string"},"message":{"type":"string","title":"Message","default":"Invalid or missing credentials.","uniqueKey":"message","typeLabel":"string"},"details":{"oneOf":[{"type":"object","title":"Details","additionalProperties":true,"uniqueKey":"details.oneOf.0","typeLabel":"Details · object"},{"type":"null","title":"Details","uniqueKey":"details.oneOf.1","typeLabel":"null"}],"uniqueKey":"details","typeLabel":"Details · object | null"}},"type":"object","title":"AuthenticationErrorModel","uniqueKey":"","typeLabel":"AuthenticationErrorModel · object"},"examples":{"Example":{"title":"Example","value":{"error_code":"authentication_error","message":"Invalid or missing credentials.","details":{}}}},"exampleType":"generated"}},"description":"Unauthorized","exampleType":"generated"},"8860ed26-f887-45fb-851d-0c38ff9b94cb":{"content":{"application/json":{"schema":{"properties":{"error_code":{"type":"string","const":"permission_denied","title":"Error Code","default":"permission_denied","uniqueKey":"error_code","typeLabel":"string"},"message":{"type":"string","title":"Message","default":"You do not have permission to perform this action.","uniqueKey":"message","typeLabel":"string"},"details":{"oneOf":[{"type":"object","title":"Details","additionalProperties":true,"uniqueKey":"details.oneOf.0","typeLabel":"Details · object"},{"type":"null","title":"Details","uniqueKey":"details.oneOf.1","typeLabel":"null"}],"uniqueKey":"details","typeLabel":"Details · object | null"}},"type":"object","title":"PermissionDeniedErrorModel","uniqueKey":"","typeLabel":"PermissionDeniedErrorModel · object"},"examples":{"Example":{"title":"Example","value":{"error_code":"permission_denied","message":"You do not have permission to perform this action.","details":{}}}},"exampleType":"generated"}},"description":"Forbidden","exampleType":"generated"},"1fea3f98-15a2-4f13-b752-64c5b5bbe9b9":{"description":"The workspace's data is being reset (`details.reason`: `data_reset_in_progress`); retry once the reset has finished.","content":{"application/json":{"schema":{"properties":{"message":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"error_code":{"type":"string","const":"conflict","title":"Error Code","default":"conflict","uniqueKey":"error_code","typeLabel":"string"},"details":{"oneOf":[{"type":"object","title":"Details","additionalProperties":true,"uniqueKey":"details.oneOf.0","typeLabel":"Details · object"},{"type":"null","title":"Details","uniqueKey":"details.oneOf.1","typeLabel":"null"}],"uniqueKey":"details","typeLabel":"Details · object | null"}},"type":"object","required":["message"],"title":"ConflictErrorModel","uniqueKey":"","typeLabel":"ConflictErrorModel · object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","error_code":"conflict","details":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"01699e80-2b70-4d67-9394-53ed9da3b42c":{"content":{"application/json":{"schema":{"properties":{"message":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"error_code":{"type":"string","const":"unprocessable_entity","title":"Error Code","default":"unprocessable_entity","uniqueKey":"error_code","typeLabel":"string"},"details":{"oneOf":[{"type":"object","title":"Details","additionalProperties":true,"uniqueKey":"details.oneOf.0","typeLabel":"Details · object"},{"type":"null","title":"Details","uniqueKey":"details.oneOf.1","typeLabel":"null"}],"uniqueKey":"details","typeLabel":"Details · object | null"}},"type":"object","required":["message"],"title":"UnprocessableEntityErrorModel","uniqueKey":"","typeLabel":"UnprocessableEntityErrorModel · object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","error_code":"unprocessable_entity","details":{}}}},"exampleType":"generated"}},"description":"Unprocessable Content","exampleType":"generated"},"b8168dce-118a-4b85-bac3-500dd44f5848":{"content":{"application/json":{"schema":{"properties":{"error_code":{"type":"string","const":"internal_server_error","title":"Error Code","default":"internal_server_error","uniqueKey":"error_code","typeLabel":"string"},"message":{"type":"string","title":"Message","default":"An unexpected error occurred.","uniqueKey":"message","typeLabel":"string"},"details":{"oneOf":[{"type":"object","title":"Details","additionalProperties":true,"uniqueKey":"details.oneOf.0","typeLabel":"Details · object"},{"type":"null","title":"Details","uniqueKey":"details.oneOf.1","typeLabel":"null"}],"uniqueKey":"details","typeLabel":"Details · object | null"}},"type":"object","title":"InternalServerErrorModel","uniqueKey":"","typeLabel":"InternalServerErrorModel · object"},"examples":{"Example":{"title":"Example","value":{"error_code":"internal_server_error","message":"An unexpected error occurred.","details":{}}}},"exampleType":"generated"}},"description":"Internal Server Error","exampleType":"generated"}},"security":{},"servers":{"b45a6dfc-eec4-42ae-a72a-9361a1098054":{"url":"http://localhost:8080"}}},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"adapter","siteName":"Adapter","title":"Create trigger - Adapter","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-27T19:26:56.172Z","originalFileLocation":"api-reference/Triggers/create-trigger.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"Adapter\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/adapter/QFVp-gltrPnIPgdk/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/adapter/QFVp-gltrPnIPgdk/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/adapter/QFVp-gltrPnIPgdk/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/adapter/QFVp-gltrPnIPgdk/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/adapter/QFVp-gltrPnIPgdk/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/adapter/QFVp-gltrPnIPgdk/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/adapter/QFVp-gltrPnIPgdk/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/adapter/QFVp-gltrPnIPgdk/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/adapter/QFVp-gltrPnIPgdk/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create trigger - Adapter\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Adapter\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.beta.adapter.com/api-reference/Triggers/create-trigger\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://adapter.mintlify.app/_mintlify/api/og/v2?division=Triggers\u0026amp;title=Create+trigger\u0026amp;theme=172df802757f1536c21dc595\u0026amp;signature=79d69201a764e9011fab8452ce53b55ebe3f8f59923714504031e89ff24fbd43\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create trigger - Adapter\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://adapter.mintlify.app/_mintlify/api/og/v2?division=Triggers\u0026amp;title=Create+trigger\u0026amp;theme=172df802757f1536c21dc595\u0026amp;signature=79d69201a764e9011fab8452ce53b55ebe3f8f59923714504031e89ff24fbd43\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/adapter/QFVp-gltrPnIPgdk/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Adapter\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#8765F0\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.beta.adapter.com/api-reference/Triggers/create-trigger\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/Triggers/create-trigger.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.beta.adapter.com/#organization\",\"name\":\"Adapter\",\"url\":\"https://docs.beta.adapter.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/adapter/J3Ydy4fSe61BUDTE/logo/light.svg?fit=max\u0026auto=format\u0026n=J3Ydy4fSe61BUDTE\u0026q=85\u0026s=459bd6410eb825d264414176cd7eba07\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.beta.adapter.com#website\",\"name\":\"Adapter\",\"url\":\"https://docs.beta.adapter.com\",\"publisher\":{\"@id\":\"https://docs.beta.adapter.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.beta.adapter.com/api-reference/Triggers/create-trigger#webpage\",\"url\":\"https://docs.beta.adapter.com/api-reference/Triggers/create-trigger\",\"name\":\"Create trigger\",\"dateModified\":\"2026-10-27T19:26:56.172Z\",\"isPartOf\":{\"@id\":\"https://docs.beta.adapter.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.beta.adapter.com/api-reference/Triggers/create-trigger#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.beta.adapter.com/api-reference/Triggers/create-trigger#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Triggers\",\"item\":\"https://docs.beta.adapter.com/api-reference/Triggers/list-triggers\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create trigger\",\"item\":\"https://docs.beta.adapter.com/api-reference/Triggers/create-trigger\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.beta.adapter.com/api-reference/Triggers/create-trigger#apireference\",\"headline\":\"Create trigger\",\"name\":\"Create trigger\",\"url\":\"https://docs.beta.adapter.com/api-reference/Triggers/create-trigger\",\"mainEntityOfPage\":{\"@id\":\"https://docs.beta.adapter.com/api-reference/Triggers/create-trigger#webpage\"},\"dateModified\":\"2026-10-27T19:26:56.172Z\",\"publisher\":{\"@id\":\"https://docs.beta.adapter.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.beta.adapter.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Adapter\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Adapter","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/getting-started/introduction"}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/getting-started/mcp"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"Overview","href":"/api-reference/introduction"}]},{"group":"Connectors","expanded":false,"pages":[{"title":"List Connections","openapi":"GET /v1/connections","href":"/api-reference/connectors/list-connections"},{"title":"Get Connection","openapi":"GET /v1/connections/{connection_id}","href":"/api-reference/connectors/get-connection"},{"title":"List Resource Facets","openapi":"GET /v1/connections/{connection_id}/resources/{resource}/facets/{facet_name}","href":"/api-reference/connectors/list-resource-facets"}]},{"group":"Custom Connectors","expanded":false,"pages":[{"title":"List custom connectors","openapi":"GET /v1/custom-connectors","href":"/api-reference/custom-connectors/list-custom-connectors"},{"title":"Create a custom connector","openapi":"POST /v1/custom-connectors","href":"/api-reference/custom-connectors/create-custom-connector"},{"title":"Get a custom connector","openapi":"GET /v1/custom-connectors/{connector_id}","href":"/api-reference/custom-connectors/get-custom-connector"},{"title":"Update a custom connector","openapi":"PATCH /v1/custom-connectors/{connector_id}","href":"/api-reference/custom-connectors/update-custom-connector"},{"title":"Deactivate a custom connector","openapi":"DELETE /v1/custom-connectors/{connector_id}","href":"/api-reference/custom-connectors/delete-custom-connector"}]},{"group":"Data","expanded":false,"pages":[{"title":"Download Document Raw","openapi":"GET /v1/data/{connection_id}/{resource}/raw/{external_id}","href":"/api-reference/data/download-document-raw"},{"title":"Get Document Detail","openapi":"GET /v1/data/{connection_id}/{resource}/{external_id}","href":"/api-reference/data/get-document-detail"}]},{"group":"Documents","expanded":false,"pages":[{"title":"Get Document By Urn","openapi":"GET /v1/documents/{urn}","href":"/api-reference/documents/get-document-by-urn"},{"title":"Download Document By Urn","openapi":"GET /v1/documents/{urn}/raw","href":"/api-reference/documents/download-document-by-urn"}]},{"group":"Ingestion","expanded":false,"pages":[{"title":"Ingest generic JSON events","openapi":"POST /v1/custom-connectors/{connector_id}/ingest","href":"/api-reference/ingestion/ingest-custom"},{"title":"Upload a binary as a generic event","openapi":"POST /v1/custom-connectors/{connector_id}/ingest/upload","href":"/api-reference/ingestion/ingest-custom-upload"},{"title":"Start a presigned video upload","openapi":"POST /v1/custom-connectors/{connector_id}/ingest/video/upload-url","href":"/api-reference/ingestion/ingest-video-upload-url"},{"title":"Finalize a presigned video upload","openapi":"POST /v1/custom-connectors/{connector_id}/ingest/video/complete","href":"/api-reference/ingestion/ingest-video-complete"},{"title":"Ingest typed first-party events","openapi":"POST /v1/custom-connectors/{connector_id}/ingest/typed","href":"/api-reference/ingestion/ingest-typed"},{"title":"Upload a binary as a typed event","openapi":"POST /v1/custom-connectors/{connector_id}/ingest/typed/upload","href":"/api-reference/ingestion/ingest-typed-upload"}]},{"group":"Knowledge","expanded":false,"pages":[{"title":"Search","openapi":"POST /v1/knowledge/search","href":"/api-reference/knowledge/search"},{"title":"Ask","openapi":"POST /v1/knowledge/ask","href":"/api-reference/knowledge/ask"},{"title":"Ask Stream","openapi":"POST /v1/knowledge/ask/stream","href":"/api-reference/knowledge/ask-stream"},{"title":"List Ask Jobs","openapi":"GET /v1/knowledge/ask/jobs","href":"/api-reference/knowledge/list-ask-jobs"},{"title":"Create Ask Job","openapi":"POST /v1/knowledge/ask/jobs","href":"/api-reference/knowledge/create-ask-job"},{"title":"Get Ask Job","openapi":"GET /v1/knowledge/ask/jobs/{job_id}","href":"/api-reference/knowledge/get-ask-job"},{"title":"Get Entity","openapi":"GET /v1/knowledge/entities/{entity_id}","href":"/api-reference/knowledge/get-entity"},{"title":"Refresh Context","openapi":"POST /v1/knowledge/refresh","href":"/api-reference/knowledge/refresh-context"},{"title":"Context Status","openapi":"GET /v1/knowledge/status","href":"/api-reference/knowledge/context-status"},{"title":"Get Knowledge Settings","openapi":"GET /v1/knowledge/settings","href":"/api-reference/knowledge/get-knowledge-settings"},{"title":"Update Knowledge Settings","openapi":"PATCH /v1/knowledge/settings","href":"/api-reference/knowledge/update-knowledge-settings"}]},{"group":"Triggers","expanded":false,"pages":[{"title":"List triggers","openapi":"GET /v1/triggers","description":null,"href":"/api-reference/Triggers/list-triggers"},{"title":"Create trigger","openapi":"POST /v1/triggers","href":"/api-reference/Triggers/create-trigger"},{"title":"List trigger registry","openapi":"GET /v1/triggers/kinds","description":null,"href":"/api-reference/Triggers/list-trigger-kinds"},{"title":"Get delivery counts","openapi":"GET /v1/triggers/deliveries/summary","href":"/api-reference/Triggers/get-trigger-delivery-summary"},{"title":"Get trigger details","openapi":"GET /v1/triggers/{trigger_id}","href":"/api-reference/Triggers/get-trigger"},{"title":"Update trigger","openapi":"PATCH /v1/triggers/{trigger_id}","href":"/api-reference/Triggers/update-trigger"},{"title":"Delete trigger","openapi":"DELETE /v1/triggers/{trigger_id}","href":"/api-reference/Triggers/delete-trigger"},{"title":"List deliveries","openapi":"GET /v1/triggers/{trigger_id}/deliveries","href":"/api-reference/Triggers/list-trigger-deliveries"}]},{"group":"Writeback","expanded":false,"pages":[{"title":"Write agent output back into the workspace","openapi":"POST /v1/writeback","href":"/api-reference/writeback/write-back"},{"title":"Recently written-back items","openapi":"GET /v1/writeback/recent","href":"/api-reference/writeback/recent-writebacks"}]}]}]},"basePath":"","title":"Create trigger - Adapter","buildId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","deploymentId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-B7XKH4J3.js","utils-lOYzL7z-.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DF6jUUIM.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dpsj5f7C.js","snippetPresets-CYeiDe8v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CUFz1YZ_.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D8H_iLS4.js","shallow-DdluZBHX.js","getApiPlaygroundDisplay-B9922vev.js","CodeSnippet-CMoRNGYs.js","CodeSnippets-DwyrPHuw.js","Page-DSVu9Ucl.js","getPastedJson-G-zIvlHh.js","icon-B03fnEy0.js","MethodPill-CW7teklc.js","DuplicateIcon-CtO8eekd.js","createIcon-DZTKdM_A.js","DynamicMarkdown-D5M2At0B.js","SectionHeading-C_2NaA2U.js","axios-vUo_bRtp.js","Markdown-D7QRHV3m.js","clsx-D1Z-ELXV.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-lvhuD9Du.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CKfC4ywL.js"]}