Add one recipient to a triggered project, the way an api trigger works: call this when something happens in your CRM or form. The message sends after the trigger’s delay_minutes; a text that comes due between 10 PM and 8 AM in the recipient’s time zone (by area code) is held until 8 AM. Opted-out numbers are never sent to and return 409CONTACT_OPTED_OUT.
The project must be started and not paused. A paused or never started project refuses new recipients with 409 rather than queueing them. A person enters once: a second entry for the same person returns 200already_entered. Send an occurrence_id so a retry of the same event is a no-op (200already_entered). A malformed body (a missing or badly formatted phone_number, an unknown key) is a 400. A well-formed US-style number that cannot be texted, because its area code is outside the United States, is a 422 with details.reasoninvalid_phone.
Authenticate every request by passing your API key in the X-API-Key header. Keys are scoped to your organization hierarchy. A key carries up to three permissions: public:read for GET requests, public:write for POST, PATCH, and PUT requests, and public:delete for DELETE requests. public:delete is only available together with public:write.
Headers
Idempotency-Key
string
Optional idempotency key: a unique string of 16-200 printable ASCII characters (a UUID is recommended). Retrying the write with the same key within 24 hours returns the stored response of the first call with an X-Idempotent-Replayed: true response header instead of executing it again. Reusing a key with a different request body returns 422 (IDEMPOTENCY_MISMATCH); a duplicate sent while the first call is still running returns 409 with a Retry-After header. Keys are scoped per endpoint and organization.
Required string length: 16 - 200
Path Parameters
id
string
required
Resource ID
Body
application/json
phone_number
string
required
US/Canada number in E.164 format, e.g. +12025550141.
Pattern: ^\+1[2-9]\d{9}$
fields
object
Optional values for this recipient, up to 50 keys with scalar values. Each is stored as a string of up to 1024 characters, can be used as a merge tag in the message (for example {first_name}), and appears in reports, exports and the contact.custom_fields of outbound webhooks.
Show child attributes
occurrence_id
string
Your own id for the event that adds this person. Sending the same occurrence_id again is a no-op, so a retry cannot add or send twice.
Maximum string length: 128
Response
Nothing was added because this person or this occurrence_id was already entered; reason says which. A safe answer to a retry.
success
boolean
required
data
object
required
The outcome of adding one recipient.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Political Comms","description":"Documentation for the Political Comms P2P texting platform - help center, onboarding, compliance, and API reference.","colors":{"primary":"#1E3A8A","light":"#3B82F6","dark":"#1E3A8A"},"logo":{"light":"https://mintcdn.com/politicalcomms/EWPdkQOGp2k4Npo5/logo/main.png?fit=max\u0026auto=format\u0026n=EWPdkQOGp2k4Npo5\u0026q=85\u0026s=694b5108d71882d5774bc62c478bc370","dark":"https://mintcdn.com/politicalcomms/EWPdkQOGp2k4Npo5/logo/main.png?fit=max\u0026auto=format\u0026n=EWPdkQOGp2k4Npo5\u0026q=85\u0026s=694b5108d71882d5774bc62c478bc370","href":"/"},"favicon":"https://mintcdn.com/politicalcomms/EWPdkQOGp2k4Npo5/favicon.png?fit=max\u0026auto=format\u0026n=EWPdkQOGp2k4Npo5\u0026q=85\u0026s=63a87e09739757db232880f7adfda947","navbar":{"links":[{"href":"mailto:support@politicalcomms.com","label":"Support"}],"primary":{"type":"button","label":"Sign in","href":"https://app.politicalcomms.com"}},"footer":{"socials":{"website":"https://politicalcomms.com"},"links":[{"header":"Product","items":[{"label":"Dashboard","href":"https://app.politicalcomms.com"},{"label":"Pricing","href":"https://politicalcomms.com/pricing"},{"label":"Status","href":"https://status.politicalcomms.com"}]},{"header":"Resources","items":[{"label":"Help Center","href":"/help/getting-started"},{"label":"Onboarding","href":"/onboarding/overview"},{"label":"Compliance","href":"/compliance/overview"},{"label":"API Reference","href":"/api-reference/introduction"}]},{"header":"Legal","items":[{"label":"Terms of Use","href":"/legal/terms"},{"label":"Privacy Policy","href":"/legal/privacy"}]}]},"seo":{"metatags":{"og:site_name":"Political Comms Docs","og:type":"website","og:locale":"en_US","og:image":"https://politicalcomms.com/opengraph-image","og:image:width":"1200","og:image:height":"630","og:image:alt":"Political Comms. The direct-to-carrier political texting platform.","twitter:card":"summary_large_image","twitter:image":"https://politicalcomms.com/opengraph-image","twitter:image:alt":"Political Comms. The direct-to-carrier political texting platform.","robots":"index, follow, max-image-preview:large, max-snippet:-1","author":"Political Comms","publisher":"Political Comms","application-name":"Political Comms Docs","apple-mobile-web-app-title":"Political Comms Docs","theme-color":"#254692","msapplication-TileColor":"#254692","category":"Political Technology, Communications Infrastructure","keywords":"political texting, political SMS, P2P messaging, 10DLC registration, Campaign Verify, TCPA compliance, FCC political rules, MCP server, AI agent integration"},"indexing":"all"},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Dashboard","icon":"arrow-up-right-from-square","href":"https://app.politicalcomms.com"},{"anchor":"Status","icon":"signal","href":"https://status.politicalcomms.com"},{"anchor":"Changelog","icon":"clock-rotate-left","href":"/changelog"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"politicalcomms","hasAudioNarration":false,"actualSubdomain":"politicalcomms","customDomains":["docs.politicalcomms.com"],"gitSource":{"type":"github","owner":"political-comms","repo":"political-comms-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6afd31fc9deede0253cdea72","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"API Reference","count":85},{"language":"default","tag":"Endpoints","count":70},{"language":"default","tag":"Documentation","count":44},{"language":"default","tag":"Email","count":27},{"language":"default","tag":"Text","count":23},{"language":"default","tag":"Assets","count":18},{"language":"default","tag":"Help Center","count":17},{"language":"default","tag":"Projects","count":17},{"language":"default","tag":"Email Campaigns","count":11},{"language":"default","tag":"Get Started","count":8}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"rbac-expansion","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":"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":"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":"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},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/projects/add-recipient","slug":"/api-reference/projects/add-recipient","pageMetadata":{"title":"Add Recipient","description":"Add one recipient to a triggered project, the way an `api` trigger works: call this when something happens in your CRM or form. The message sends after the trigger's `delay_minutes`; a text that comes due between 10 PM and 8 AM in the recipient's time zone (by area code) is held until 8 AM. Opted-out numbers are never sent to and return `409` `CONTACT_OPTED_OUT`.\n\nThe project must be started and not paused. A paused or never started project refuses new recipients with `409` rather than queueing them. A person enters once: a second entry for the same person returns `200` `already_entered`. Send an `occurrence_id` so a retry of the same event is a no-op (`200` `already_entered`). A malformed body (a missing or badly formatted `phone_number`, an unknown key) is a 400. A well-formed US-style number that cannot be texted, because its area code is outside the United States, is a 422 with `details.reason` `invalid_phone`.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /projects/{id}/recipients","href":"/api-reference/projects/add-recipient","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Add one recipient to a triggered project, the way an \", _jsx(_components.code, {\n children: \"api\"\n }), \" trigger works: call this when something happens in your CRM or form. The message sends after the trigger’s \", _jsx(_components.code, {\n children: \"delay_minutes\"\n }), \"; a text that comes due between 10 PM and 8 AM in the recipient’s time zone (by area code) is held until 8 AM. Opted-out numbers are never sent to and return \", _jsx(_components.code, {\n children: \"409\"\n }), \" \", _jsx(_components.code, {\n children: \"CONTACT_OPTED_OUT\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"The project must be started and not paused. A paused or never started project refuses new recipients with \", _jsx(_components.code, {\n children: \"409\"\n }), \" rather than queueing them. A person enters once: a second entry for the same person returns \", _jsx(_components.code, {\n children: \"200\"\n }), \" \", _jsx(_components.code, {\n children: \"already_entered\"\n }), \". Send an \", _jsx(_components.code, {\n children: \"occurrence_id\"\n }), \" so a retry of the same event is a no-op (\", _jsx(_components.code, {\n children: \"200\"\n }), \" \", _jsx(_components.code, {\n children: \"already_entered\"\n }), \"). A malformed body (a missing or badly formatted \", _jsx(_components.code, {\n children: \"phone_number\"\n }), \", an unknown key) is a 400. A well-formed US-style number that cannot be texted, because its area code is outside the United States, is a 422 with \", _jsx(_components.code, {\n children: \"details.reason\"\n }), \" \", _jsx(_components.code, {\n children: \"invalid_phone\"\n }), \".\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"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,{})}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":"Add Recipient","description":"Add one recipient to a triggered project, the way an `api` trigger works: call this when something happens in your CRM or form. The message sends after the trigger's `delay_minutes`; a text that comes due between 10 PM and 8 AM in the recipient's time zone (by area code) is held until 8 AM. Opted-out numbers are never sent to and return `409` `CONTACT_OPTED_OUT`.\n\nThe project must be started and not paused. A paused or never started project refuses new recipients with `409` rather than queueing them. A person enters once: a second entry for the same person returns `200` `already_entered`. Send an `occurrence_id` so a retry of the same event is a no-op (`200` `already_entered`). A malformed body (a missing or badly formatted `phone_number`, an unknown key) is a 400. A well-formed US-style number that cannot be texted, because its area code is outside the United States, is a 422 with `details.reason` `invalid_phone`.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /projects/{id}/recipients","href":"/api-reference/projects/add-recipient","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Projects"],"summary":"Add Recipient","description":"Add one recipient to a triggered project, the way an `api` trigger works: call this when something happens in your CRM or form. The message sends after the trigger's `delay_minutes`; a text that comes due between 10 PM and 8 AM in the recipient's time zone (by area code) is held until 8 AM. Opted-out numbers are never sent to and return `409` `CONTACT_OPTED_OUT`.\n\nThe project must be started and not paused. A paused or never started project refuses new recipients with `409` rather than queueing them. A person enters once: a second entry for the same person returns `200` `already_entered`. Send an `occurrence_id` so a retry of the same event is a no-op (`200` `already_entered`). A malformed body (a missing or badly formatted `phone_number`, an unknown key) is a 400. A well-formed US-style number that cannot be texted, because its area code is outside the United States, is a 422 with `details.reason` `invalid_phone`.","operationId":"addProjectRecipient","parameters":["f0a78d06-57d5-4f97-a378-9962216536bb","dfdb6c09-e44d-464b-bcbd-747cc8364187"],"requestBody":"b8e494f0-7efd-404d-a41b-f8d0292498d3","responses":{"200":"0c70ac7b-01ae-4c9c-a9ed-52bba5282266","202":"f46b26c4-8da8-4c8c-8d91-8b48ac2ec313","400":"5a16510b-0015-418e-acd8-e5cb6b20cf6d","401":"e9d90929-2cd3-4b41-96da-b625b5fe8947","403":"666c2031-ccab-4cb8-911e-a70a5d0878eb","404":"0ac697cd-c3ae-449e-b0c4-1b8feff421ae","409":"fc8ddfdf-de6c-4e33-942b-6cb86baf9991","422":"b3ea9269-6f58-4ea5-9888-d2b8c5d382ae","429":"9f588bbd-d00c-4cb4-83af-19d24d92d663","500":"f950abca-76a0-4373-ba47-6e068b2df087"},"method":"post","type":"path","servers":["fcd84e1e-1c26-4c64-8731-2bb387e0f427"],"security":["fbc9bba6-3fb1-413e-a370-4806d5231510"],"path":"/projects/{id}/recipients","baseUrlOptions":["https://api.politicalcomms.com/v1"],"title":"Add Recipient","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"f0a78d06-57d5-4f97-a378-9962216536bb":{"name":"id","in":"path","required":true,"description":"Resource ID","schema":{"type":"string","isRequired":true,"description":"Resource ID","uniqueKey":"","typeLabel":"string"}},"dfdb6c09-e44d-464b-bcbd-747cc8364187":{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":16,"maxLength":200,"isRequired":false,"description":"Optional idempotency key: a unique string of 16-200 printable ASCII characters (a UUID is recommended). Retrying the write with the same key within 24 hours returns the stored response of the first call with an `X-Idempotent-Replayed: true` response header instead of executing it again. Reusing a key with a different request body returns `422` (`IDEMPOTENCY_MISMATCH`); a duplicate sent while the first call is still running returns `409` with a `Retry-After` header. Keys are scoped per endpoint and organization.","uniqueKey":"","typeLabel":"string"},"description":"Optional idempotency key: a unique string of 16-200 printable ASCII characters (a UUID is recommended). Retrying the write with the same key within 24 hours returns the stored response of the first call with an `X-Idempotent-Replayed: true` response header instead of executing it again. Reusing a key with a different request body returns `422` (`IDEMPOTENCY_MISMATCH`); a duplicate sent while the first call is still running returns `409` with a `Retry-After` header. Keys are scoped per endpoint and organization."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["phone_number"],"properties":{"phone_number":{"type":"string","description":"US/Canada number in E.164 format, e.g. +12025550141.","pattern":"^\\+1[2-9]\\d{9}$","isRequired":true,"uniqueKey":"phone_number","typeLabel":"string"},"fields":{"type":"object","maxProperties":50,"additionalProperties":{"oneOf":[{"type":"string","maxLength":1024,"uniqueKey":"fields.additionalProperties.oneOf.0","typeLabel":"string"},{"type":"number","maxLength":1024,"uniqueKey":"fields.additionalProperties.oneOf.1","typeLabel":"number"},{"type":"boolean","maxLength":1024,"uniqueKey":"fields.additionalProperties.oneOf.2","typeLabel":"boolean"}],"uniqueKey":"fields.additionalProperties","typeLabel":"string | number | boolean"},"description":"Optional values for this recipient, up to 50 keys with scalar values. Each is stored as a string of up to 1024 characters, can be used as a merge tag in the message (for example `{first_name}`), and appears in reports, exports and the `contact.custom_fields` of outbound webhooks.","uniqueKey":"fields","typeLabel":"object"},"occurrence_id":{"type":"string","maxLength":128,"description":"Your own id for the event that adds this person. Sending the same `occurrence_id` again is a no-op, so a retry cannot add or send twice.","uniqueKey":"occurrence_id","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"example":{"phone_number":"+12025550141","fields":{"first_name":"Ada","amount":25},"occurrence_id":"evt_123"},"examples":{"Example":{"title":"Example","value":{"phone_number":"+12025550141","fields":{"first_name":"Ada","amount":25},"occurrence_id":"evt_123"}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"0c70ac7b-01ae-4c9c-a9ed-52bba5282266":{"description":"Nothing was added because this person or this `occurrence_id` was already entered; `reason` says which. A safe answer to a retry.","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"type":"boolean","isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"data":{"type":"object","description":"The outcome of adding one recipient.","required":["status"],"properties":{"status":{"type":"string","enum":["queued","already_entered"],"isRequired":true,"uniqueKey":"data.status","typeLabel":"enum\u003cstring>"},"send_at":{"type":"string","format":"date-time","description":"Present when `status` is `queued`: when the message will send, after any delay and any overnight hold.","uniqueKey":"data.send_at","typeLabel":"string\u003cdate-time>"},"reason":{"type":"string","enum":["duplicate","already_entered"],"description":"Present when `status` is `already_entered`. `duplicate`: this `occurrence_id` was already received. `already_entered`: this person already entered; a person is sent a triggered project or campaign once.","uniqueKey":"data.reason","typeLabel":"enum\u003cstring>"}},"additionalProperties":true,"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"example":{"success":true,"data":{"status":"already_entered","reason":"duplicate"}},"examples":{"Example":{"title":"Example","value":{"success":true,"data":{"status":"already_entered","reason":"duplicate"}}}},"exampleType":"examples"}},"exampleType":"examples"},"f46b26c4-8da8-4c8c-8d91-8b48ac2ec313":{"description":"Recipient queued. `send_at` is when the message will send.","content":{"application/json":{"schema":{"type":"object","required":["success","data"],"properties":{"success":{"type":"boolean","isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"data":{"type":"object","description":"The outcome of adding one recipient.","required":["status"],"properties":{"status":{"type":"string","enum":["queued","already_entered"],"isRequired":true,"uniqueKey":"data.status","typeLabel":"enum\u003cstring>"},"send_at":{"type":"string","format":"date-time","description":"Present when `status` is `queued`: when the message will send, after any delay and any overnight hold.","uniqueKey":"data.send_at","typeLabel":"string\u003cdate-time>"},"reason":{"type":"string","enum":["duplicate","already_entered"],"description":"Present when `status` is `already_entered`. `duplicate`: this `occurrence_id` was already received. `already_entered`: this person already entered; a person is sent a triggered project or campaign once.","uniqueKey":"data.reason","typeLabel":"enum\u003cstring>"}},"additionalProperties":true,"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"example":{"success":true,"data":{"status":"queued","send_at":"2026-11-13T14:00:00.000Z"}},"examples":{"Example":{"title":"Example","value":{"success":true,"data":{"status":"queued","send_at":"2026-11-13T14:00:00.000Z"}}}},"exampleType":"examples"}},"exampleType":"examples"},"5a16510b-0015-418e-acd8-e5cb6b20cf6d":{"description":"The body failed validation (`VALIDATION_ERROR`, including an `email_column` that is not a header, with `details: { field: \"email_column\", headers }`, or a named column whose first rows are not what it was chosen for, such as `The column \"SURVEY_LINK\" does not contain email addresses. Choose the column that holds emails, or set the email column to None.` with `details: { field }`), the phone column is not a header (`PHONE_COLUMN_NOT_FOUND`, `details: { phoneColumn, headers }`), a merge tag is invalid (`INVALID_MERGE_TAGS`, `UNKNOWN_STANDARD_TAG`, `MERGE_TAG_COLUMN_NOT_FOUND`, `INVALID_MERGE_TAG_NAME`), the file is not a readable CSV (`INVALID_CSV`), the brand belongs to another organization than `organization_id` (`BRAND_ORG_MISMATCH`), or `source_url` is not a public HTTPS URL (`INVALID_SOURCE_URL`). Nothing is written.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code, e.g. VALIDATION_ERROR, ORG_ACCESS_DENIED, PROJECT_NOT_FOUND.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"correlationId":{"type":"string","description":"Request correlation ID; include it in support requests.","uniqueKey":"correlationId","typeLabel":"string"},"details":{"oneOf":[{"type":"array","description":"Present on some errors. For VALIDATION_ERROR, an array of { field, message, code } with one entry per rejected field (field is the dotted path); an object for other codes (e.g. insufficient-balance shortfall).","uniqueKey":"details.oneOf.0","typeLabel":"array"},{"type":"object","description":"Present on some errors. For VALIDATION_ERROR, an array of { field, message, code } with one entry per rejected field (field is the dotted path); an object for other codes (e.g. insufficient-balance shortfall).","uniqueKey":"details.oneOf.1","typeLabel":"object"}],"uniqueKey":"details","typeLabel":"array | object"}},"required":["error","code"],"additionalProperties":true,"description":"Standard error body produced by the API error handler for 4xx/5xx responses.","uniqueKey":"","typeLabel":"object"},"example":{"error":"phone_column \"Phone\" not found in CSV headers","code":"PHONE_COLUMN_NOT_FOUND","correlationId":"030bf857-922f-4b82-8fca-c5b0769c1590","details":{"phoneColumn":"Phone","headers":["first_name","cell","email"]}},"examples":{"Example":{"title":"Example","value":{"error":"phone_column \"Phone\" not found in CSV headers","code":"PHONE_COLUMN_NOT_FOUND","correlationId":"030bf857-922f-4b82-8fca-c5b0769c1590","details":{"phoneColumn":"Phone","headers":["first_name","cell","email"]}}}},"exampleType":"examples"}},"exampleType":"examples"},"e9d90929-2cd3-4b41-96da-b625b5fe8947":{"description":"Missing, malformed, revoked, or expired API key.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Short error summary.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Human-readable detail.","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message"],"additionalProperties":true,"description":"Error body returned by the API-key authentication layer (401 and permission 403s).","uniqueKey":"","typeLabel":"object"},"example":{"error":"API key required","message":"Please provide an API key in the X-API-Key header"},"examples":{"Example":{"title":"Example","value":{"error":"API key required","message":"Please provide an API key in the X-API-Key header"}}},"exampleType":"examples"}},"exampleType":"examples"},"666c2031-ccab-4cb8-911e-a70a5d0878eb":{"description":"The API key lacks the required permission scope, or the requested resource belongs to an organization outside the key's hierarchy.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","description":"Error body returned by the API-key authentication layer (401 and permission 403s).","required":["error","message"],"properties":{"error":{"type":"string","description":"Short error summary.","isRequired":true,"uniqueKey":"oneOf.0.error","typeLabel":"string"},"message":{"type":"string","description":"Human-readable detail.","isRequired":true,"uniqueKey":"oneOf.0.message","typeLabel":"string"}},"additionalProperties":true,"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","description":"Standard error body produced by the API error handler for 4xx/5xx responses.","required":["error","code"],"properties":{"error":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"oneOf.1.error","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code, e.g. VALIDATION_ERROR, ORG_ACCESS_DENIED, PROJECT_NOT_FOUND.","isRequired":true,"uniqueKey":"oneOf.1.code","typeLabel":"string"},"correlationId":{"type":"string","description":"Request correlation ID; include it in support requests.","uniqueKey":"oneOf.1.correlationId","typeLabel":"string"},"details":{"oneOf":[{"type":"array","description":"Present on some errors. For VALIDATION_ERROR, an array of { field, message, code } with one entry per rejected field (field is the dotted path); an object for other codes (e.g. insufficient-balance shortfall).","uniqueKey":"oneOf.1.details.oneOf.0","typeLabel":"array"},{"type":"object","description":"Present on some errors. For VALIDATION_ERROR, an array of { field, message, code } with one entry per rejected field (field is the dotted path); an object for other codes (e.g. insufficient-balance shortfall).","uniqueKey":"oneOf.1.details.oneOf.1","typeLabel":"object"}],"uniqueKey":"oneOf.1.details","typeLabel":"array | object"}},"additionalProperties":true,"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"missingScope":{"title":"missingScope","summary":"Key lacks the required permission scope (here a GET from a key without `public:read`)","value":{"error":"Insufficient permissions","message":"This API key does not have the required permissions: public:read"}},"orgAccessDenied":{"title":"orgAccessDenied","summary":"Resource outside the key's organization hierarchy","value":{"error":"Access denied: You do not have permission to access this organization's data","code":"ORG_ACCESS_DENIED","correlationId":"de038205-7c9c-4d4a-99bc-d7275a52f07e"}}},"exampleType":"examples"}},"exampleType":"examples"},"0ac697cd-c3ae-449e-b0c4-1b8feff421ae":{"description":"Project not found. Error code PROJECT_NOT_FOUND.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code, e.g. VALIDATION_ERROR, ORG_ACCESS_DENIED, PROJECT_NOT_FOUND.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"correlationId":{"type":"string","description":"Request correlation ID; include it in support requests.","uniqueKey":"correlationId","typeLabel":"string"},"details":{"oneOf":[{"type":"array","description":"Present on some errors. For VALIDATION_ERROR, an array of { field, message, code } with one entry per rejected field (field is the dotted path); an object for other codes (e.g. insufficient-balance shortfall).","uniqueKey":"details.oneOf.0","typeLabel":"array"},{"type":"object","description":"Present on some errors. For VALIDATION_ERROR, an array of { field, message, code } with one entry per rejected field (field is the dotted path); an object for other codes (e.g. insufficient-balance shortfall).","uniqueKey":"details.oneOf.1","typeLabel":"object"}],"uniqueKey":"details","typeLabel":"array | object"}},"required":["error","code"],"additionalProperties":true,"description":"Standard error body produced by the API error handler for 4xx/5xx responses.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"\u003cstring>","correlationId":"\u003cstring>","details":"\u003carray>"}}},"exampleType":"generated"}},"exampleType":"generated"},"fc8ddfdf-de6c-4e33-942b-6cb86baf9991":{"description":"Not accepting recipients. Error code CONFLICT when the project is not triggered or is not active (a paused or never started one refuses recipients rather than queueing them), or CONTACT_OPTED_OUT when this phone number is opted out or suppressed.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code, e.g. VALIDATION_ERROR, ORG_ACCESS_DENIED, PROJECT_NOT_FOUND.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"correlationId":{"type":"string","description":"Request correlation ID; include it in support requests.","uniqueKey":"correlationId","typeLabel":"string"},"details":{"oneOf":[{"type":"array","description":"Present on some errors. For VALIDATION_ERROR, an array of { field, message, code } with one entry per rejected field (field is the dotted path); an object for other codes (e.g. insufficient-balance shortfall).","uniqueKey":"details.oneOf.0","typeLabel":"array"},{"type":"object","description":"Present on some errors. For VALIDATION_ERROR, an array of { field, message, code } with one entry per rejected field (field is the dotted path); an object for other codes (e.g. insufficient-balance shortfall).","uniqueKey":"details.oneOf.1","typeLabel":"object"}],"uniqueKey":"details","typeLabel":"array | object"}},"required":["error","code"],"additionalProperties":true,"description":"Standard error body produced by the API error handler for 4xx/5xx responses.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"\u003cstring>","correlationId":"\u003cstring>","details":"\u003carray>"}}},"exampleType":"generated"}},"exampleType":"generated"},"b3ea9269-6f58-4ea5-9888-d2b8c5d382ae":{"description":"The phone number cannot be sent to. Error code VALIDATION_ERROR; `details` carries `field` and `reason`.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code, e.g. VALIDATION_ERROR, ORG_ACCESS_DENIED, PROJECT_NOT_FOUND.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"correlationId":{"type":"string","description":"Request correlation ID; include it in support requests.","uniqueKey":"correlationId","typeLabel":"string"},"details":{"oneOf":[{"type":"array","description":"Present on some errors. For VALIDATION_ERROR, an array of { field, message, code } with one entry per rejected field (field is the dotted path); an object for other codes (e.g. insufficient-balance shortfall).","uniqueKey":"details.oneOf.0","typeLabel":"array"},{"type":"object","description":"Present on some errors. For VALIDATION_ERROR, an array of { field, message, code } with one entry per rejected field (field is the dotted path); an object for other codes (e.g. insufficient-balance shortfall).","uniqueKey":"details.oneOf.1","typeLabel":"object"}],"uniqueKey":"details","typeLabel":"array | object"}},"required":["error","code"],"additionalProperties":true,"description":"Standard error body produced by the API error handler for 4xx/5xx responses.","uniqueKey":"","typeLabel":"object"},"example":{"error":"phone_number cannot be sent to","code":"VALIDATION_ERROR","details":{"field":"phone_number","reason":"invalid"}},"examples":{"Example":{"title":"Example","value":{"error":"phone_number cannot be sent to","code":"VALIDATION_ERROR","details":{"field":"phone_number","reason":"invalid"}}}},"exampleType":"examples"}},"exampleType":"examples"},"9f588bbd-d00c-4cb4-83af-19d24d92d663":{"description":"Rate limit exceeded. Check the Retry-After header.","headers":{"Retry-After":{"description":"Seconds until the window resets.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false],"isRequired":true,"uniqueKey":"success","typeLabel":"enum\u003cboolean>"},"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","enum":["RATE_LIMIT_EXCEEDED"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"statusCode":{"type":"integer","enum":[429],"isRequired":true,"uniqueKey":"statusCode","typeLabel":"enum\u003cinteger>"},"retryAfter":{"type":"integer","description":"Seconds until the rate-limit window resets. Also sent as the Retry-After header.","isRequired":true,"uniqueKey":"retryAfter","typeLabel":"integer"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"required":["success","error","code","statusCode","retryAfter"],"additionalProperties":true,"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"error":"Rate limit exceeded","message":"Maximum 600 requests per 60 seconds","code":"RATE_LIMIT_EXCEEDED","statusCode":429,"retryAfter":3},"examples":{"Example":{"title":"Example","value":{"success":false,"error":"Rate limit exceeded","message":"Maximum 600 requests per 60 seconds","code":"RATE_LIMIT_EXCEEDED","statusCode":429,"retryAfter":3}}},"exampleType":"examples"}},"exampleType":"examples"},"f950abca-76a0-4373-ba47-6e068b2df087":{"description":"Unexpected server error.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code, e.g. VALIDATION_ERROR, ORG_ACCESS_DENIED, PROJECT_NOT_FOUND.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"correlationId":{"type":"string","description":"Request correlation ID; include it in support requests.","uniqueKey":"correlationId","typeLabel":"string"},"details":{"oneOf":[{"type":"array","description":"Present on some errors. For VALIDATION_ERROR, an array of { field, message, code } with one entry per rejected field (field is the dotted path); an object for other codes (e.g. insufficient-balance shortfall).","uniqueKey":"details.oneOf.0","typeLabel":"array"},{"type":"object","description":"Present on some errors. For VALIDATION_ERROR, an array of { field, message, code } with one entry per rejected field (field is the dotted path); an object for other codes (e.g. insufficient-balance shortfall).","uniqueKey":"details.oneOf.1","typeLabel":"object"}],"uniqueKey":"details","typeLabel":"array | object"}},"required":["error","code"],"additionalProperties":true,"description":"Standard error body produced by the API error handler for 4xx/5xx responses.","uniqueKey":"","typeLabel":"object"},"example":{"error":"An unexpected error occurred. Please try again later.","code":"INTERNAL_ERROR","correlationId":"de038205-7c9c-4d4a-99bc-d7275a52f07e"},"examples":{"Example":{"title":"Example","value":{"error":"An unexpected error occurred. Please try again later.","code":"INTERNAL_ERROR","correlationId":"de038205-7c9c-4d4a-99bc-d7275a52f07e"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"fbc9bba6-3fb1-413e-a370-4806d5231510":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Authenticate every request by passing your API key in the X-API-Key header. Keys are scoped to your organization hierarchy. A key carries up to three permissions: `public:read` for GET requests, `public:write` for POST, PATCH, and PUT requests, and `public:delete` for DELETE requests. `public:delete` is only available together with `public:write`.","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"fcd84e1e-1c26-4c64-8731-2bb387e0f427":{"url":"https://api.politicalcomms.com/v1","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Authenticate every request by passing your API key in the X-API-Key header. Keys are scoped to your organization hierarchy. A key carries up to three permissions: `public:read` for GET requests, `public:write` for POST, PATCH, and PUT requests, and `public:delete` for DELETE requests. `public:delete` is only available together with `public:write`.","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"X-API-Key","type":"string","description":"Authenticate every request by passing your API key in the X-API-Key header. Keys are scoped to your organization hierarchy. A key carries up to three permissions: `public:read` for GET requests, `public:write` for POST, PATCH, and PUT requests, and `public:delete` for DELETE requests. `public:delete` is only available together with `public:write`.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"X-API-Key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"politicalcomms","siteName":"Political Comms","title":"Add Recipient - Political Comms","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-18T05:05:05.189Z","originalFileLocation":"api-reference/projects/add-recipient.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=\"description\" content=\"Add one recipient to a triggered project, the way an api trigger works: call this when something happens in your CRM or form. The message sends after the trigger\u0026#x27;s delay_minutes; a text that comes due between 10 PM and 8 AM in the recipient\u0026#x27;s time zone (by area code) is held until 8 AM. Opted-out numbers are never sent to and return 409 CONTACT_OPTED_OUT. The project must be started and not paused. A paused or never started project refuses new recipients with 409 rather than queueing them. A person enters once: a second entry for the same person returns 200 already_entered. Send an occurrence_id so a retry of the same event is a no-op (200 already_entered). A malformed body (a missing or badly formatted phone_number, an unknown key) is a 400. A well-formed US-style number that cannot be texted, because its area code is outside the United States, is a 422 with details.reason invalid_phone.\">\u003cmeta data-mint-head name=\"keywords\" content=\"political texting, political SMS, P2P messaging, 10DLC registration, Campaign Verify, TCPA compliance, FCC political rules, MCP server, AI agent integration\">\u003cmeta data-mint-head name=\"application-name\" content=\"Political Comms\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow, max-image-preview:large, max-snippet:-1\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/politicalcomms/3u6PEpheVhjd9O_C/_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/politicalcomms/3u6PEpheVhjd9O_C/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/politicalcomms/3u6PEpheVhjd9O_C/_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/politicalcomms/3u6PEpheVhjd9O_C/_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/politicalcomms/3u6PEpheVhjd9O_C/_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/politicalcomms/3u6PEpheVhjd9O_C/_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/politicalcomms/3u6PEpheVhjd9O_C/_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/politicalcomms/3u6PEpheVhjd9O_C/_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/politicalcomms/3u6PEpheVhjd9O_C/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Add Recipient - Political Comms\">\u003cmeta data-mint-head property=\"og:description\" content=\"Add one recipient to a triggered project, the way an api trigger works: call this when something happens in your CRM or form. The message sends after the trigger\u0026#x27;s delay_minutes; a text that comes due between 10 PM and 8 AM in the recipient\u0026#x27;s time zone (by area code) is held until 8 AM. Opted-out numbers are never sent to and return 409 CONTACT_OPTED_OUT. The project must be started and not paused. A paused or never started project refuses new recipients with 409 rather than queueing them. A person enters once: a second entry for the same person returns 200 already_entered. Send an occurrence_id so a retry of the same event is a no-op (200 already_entered). A malformed body (a missing or badly formatted phone_number, an unknown key) is a 400. A well-formed US-style number that cannot be texted, because its area code is outside the United States, is a 422 with details.reason invalid_phone.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Political Comms Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.politicalcomms.com/api-reference/projects/add-recipient\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://politicalcomms.com/opengraph-image\">\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=\"Add Recipient - Political Comms\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Add one recipient to a triggered project, the way an api trigger works: call this when something happens in your CRM or form. The message sends after the trigger\u0026#x27;s delay_minutes; a text that comes due between 10 PM and 8 AM in the recipient\u0026#x27;s time zone (by area code) is held until 8 AM. Opted-out numbers are never sent to and return 409 CONTACT_OPTED_OUT. The project must be started and not paused. A paused or never started project refuses new recipients with 409 rather than queueing them. A person enters once: a second entry for the same person returns 200 already_entered. Send an occurrence_id so a retry of the same event is a no-op (200 already_entered). A malformed body (a missing or badly formatted phone_number, an unknown key) is a 400. A well-formed US-style number that cannot be texted, because its area code is outside the United States, is a 422 with details.reason invalid_phone.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://politicalcomms.com/opengraph-image\">\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/politicalcomms/3u6PEpheVhjd9O_C/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Political Comms Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#254692\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003cmeta data-mint-head name=\"og:image:alt\" content=\"Political Comms. The direct-to-carrier political texting platform.\">\u003cmeta data-mint-head name=\"twitter:image:alt\" content=\"Political Comms. The direct-to-carrier political texting platform.\">\u003cmeta data-mint-head name=\"author\" content=\"Political Comms\">\u003cmeta data-mint-head name=\"publisher\" content=\"Political Comms\">\u003cmeta data-mint-head name=\"application-name\" content=\"Political Comms Docs\">\u003cmeta data-mint-head name=\"theme-color\" content=\"#254692\">\u003cmeta data-mint-head name=\"category\" content=\"Political Technology, Communications Infrastructure\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.politicalcomms.com/api-reference/projects/add-recipient\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/projects/add-recipient.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.politicalcomms.com/#organization\",\"name\":\"Political Comms\",\"url\":\"https://docs.politicalcomms.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/politicalcomms/EWPdkQOGp2k4Npo5/logo/main.png?fit=max\u0026auto=format\u0026n=EWPdkQOGp2k4Npo5\u0026q=85\u0026s=694b5108d71882d5774bc62c478bc370\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.politicalcomms.com#website\",\"name\":\"Political Comms\",\"url\":\"https://docs.politicalcomms.com\",\"publisher\":{\"@id\":\"https://docs.politicalcomms.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.politicalcomms.com/api-reference/projects/add-recipient#webpage\",\"url\":\"https://docs.politicalcomms.com/api-reference/projects/add-recipient\",\"name\":\"Add Recipient\",\"description\":\"Add one recipient to a triggered project, the way an api trigger works: call this when something happens in your CRM or form. The message sends after the trigger's delay_minutes; a text that comes due between 10 PM and 8 AM in the recipient's time zone (by area code) is held until 8 AM. Opted-out numbers are never sent to and return 409 CONTACT_OPTED_OUT. The project must be started and not paused. A paused or never started project refuses new recipients with 409 rather than queueing them. A person enters once: a second entry for the same person returns 200 already_entered. Send an occurrence_id so a retry of the same event is a no-op (200 already_entered). A malformed body (a missing or badly formatted phone_number, an unknown key) is a 400. A well-formed US-style number that cannot be texted, because its area code is outside the United States, is a 422 with details.reason invalid_phone.\",\"dateModified\":\"2026-11-18T05:05:05.189Z\",\"isPartOf\":{\"@id\":\"https://docs.politicalcomms.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.politicalcomms.com/api-reference/projects/add-recipient#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.politicalcomms.com/api-reference/projects/add-recipient#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.politicalcomms.com/api-reference/projects/list-projects\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Text\",\"item\":\"https://docs.politicalcomms.com/api-reference/projects/list-projects\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Projects\",\"item\":\"https://docs.politicalcomms.com/api-reference/projects/list-projects\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Add Recipient\",\"item\":\"https://docs.politicalcomms.com/api-reference/projects/add-recipient\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.politicalcomms.com/api-reference/projects/add-recipient#apireference\",\"headline\":\"Add Recipient\",\"name\":\"Add Recipient\",\"description\":\"Add one recipient to a triggered project, the way an api trigger works: call this when something happens in your CRM or form. The message sends after the trigger's delay_minutes; a text that comes due between 10 PM and 8 AM in the recipient's time zone (by area code) is held until 8 AM. Opted-out numbers are never sent to and return 409 CONTACT_OPTED_OUT. The project must be started and not paused. A paused or never started project refuses new recipients with 409 rather than queueing them. A person enters once: a second entry for the same person returns 200 already_entered. Send an occurrence_id so a retry of the same event is a no-op (200 already_entered). A malformed body (a missing or badly formatted phone_number, an unknown key) is a 400. A well-formed US-style number that cannot be texted, because its area code is outside the United States, is a 422 with details.reason invalid_phone.\",\"url\":\"https://docs.politicalcomms.com/api-reference/projects/add-recipient\",\"mainEntityOfPage\":{\"@id\":\"https://docs.politicalcomms.com/api-reference/projects/add-recipient#webpage\"},\"image\":\"https://politicalcomms.com/opengraph-image\",\"dateModified\":\"2026-11-18T05:05:05.189Z\",\"publisher\":{\"@id\":\"https://docs.politicalcomms.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.politicalcomms.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Political Comms\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Political Comms\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/projects/add-recipient.md","siteName":"Political Comms","nav":{"global":{"anchors":[{"anchor":"Dashboard","icon":"arrow-up-right-from-square","href":"https://app.politicalcomms.com"},{"anchor":"Status","icon":"signal","href":"https://status.politicalcomms.com"},{"anchor":"Changelog","icon":"clock-rotate-left","href":"/changelog"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"Introduction","pages":[{"title":"Introduction","icon":"code","href":"/api-reference/introduction"},{"title":"Authentication","icon":"key","href":"/api-reference/authentication"},{"title":"Rate Limits","icon":"gauge-high","href":"/api-reference/rate-limits"},{"title":"Error Handling","icon":"circle-exclamation","href":"/api-reference/errors"},{"title":"Test Phone Numbers","icon":"flask","href":"/api-reference/testing"},{"title":"Versioning \u0026 Deprecation","href":"/api-reference/versioning"},{"title":"Best Practices","icon":"stars","href":"/api-reference/best-practices"},{"title":"Two-Way Conversations","icon":"messages","href":"/api-reference/two-way-conversations"}]},{"group":"Webhooks","pages":[{"title":"Overview","icon":"webhook","href":"/api-reference/webhooks/overview"},{"title":"Setup \u0026 Configuration","icon":"plug","href":"/api-reference/webhooks/setup"},{"title":"Signature Validation","icon":"shield-check","href":"/api-reference/webhooks/signature-validation"},{"title":"Event Types","icon":"code","href":"/api-reference/webhooks/events"},{"title":"Inbound hook","icon":"arrow-right-to-bracket","href":"/api-reference/webhooks/inbound-hook"},{"title":"Delivery Error Codes","icon":"triangle-exclamation","href":"/api-reference/webhooks/error-codes"},{"title":"Retry Policy","icon":"rotate-right","href":"/api-reference/webhooks/retry-policy"}]},{"group":"Endpoints","pages":[{"group":"Text","pages":[{"group":"Projects","pages":[{"title":"List Projects","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /projects","href":"/api-reference/projects/list-projects"},{"title":"Create Project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /projects","href":"/api-reference/projects/create-project"},{"title":"Get Project Stats (all)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /projects/stats","href":"/api-reference/projects/get-project-stats-all"},{"title":"Get Project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /projects/{id}","href":"/api-reference/projects/get-project"},{"title":"Update Project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /projects/{id}","href":"/api-reference/projects/update-project"},{"title":"Get Project Stats (single)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /projects/{id}/stats","href":"/api-reference/projects/get-project-stats-single"},{"title":"Get Project Throughput","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /projects/{id}/throughput","href":"/api-reference/projects/get-project-throughput"},{"title":"Get Survey Results","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /projects/{id}/survey-results","href":"/api-reference/projects/get-survey-results"},{"title":"Test Project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /projects/{id}/test","href":"/api-reference/projects/test-project"},{"title":"Schedule Project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /projects/{id}/schedule","href":"/api-reference/projects/schedule-project"},{"title":"Unschedule Project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /projects/{id}/unschedule","href":"/api-reference/projects/unschedule-project"},{"title":"Pause Project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /projects/{id}/pause","href":"/api-reference/projects/pause-project"},{"title":"Start Project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /projects/{id}/start","href":"/api-reference/projects/start-project"},{"title":"End Project","description":"End a triggered project for good. It moves to `completed`, adds no more recipients, and cannot be started again; create a new triggered project to keep going. Recipients still waiting are not sent. Messages already handed over finish. Ending is not the same as pausing: a paused project can resume. Ending settles what is still on its way out: texts not yet sent are cancelled and their cost returned.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /projects/{id}/end","href":"/api-reference/projects/end-project"},{"title":"Add Recipient","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /projects/{id}/recipients","href":"/api-reference/projects/add-recipient"},{"title":"Create Hook URL","description":"Create the inbound hook URL of a triggered project. Anything that can POST (Zapier or Make with their generic webhook step, n8n, a CRM, your own server) can add one recipient by sending a request to this URL, with no API key. See [Inbound hook](/api-reference/webhooks/inbound-hook) for the request body and answers.\n\nThe URL is shown only in this response. Calling this again creates a new URL and the previous one stops working at once, which is how you rotate a URL that leaked. The project must have a trigger set (any source). This call is not replayed by `Idempotency-Key`: the URL it returns is a secret shown once, so a retry mints a new URL.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /projects/{id}/hook","href":"/api-reference/projects/create-hook-url"},{"title":"Copy Project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /projects/{id}/copy","href":"/api-reference/projects/copy-project"}]},{"group":"Phone Numbers","pages":[{"title":"List Phone Numbers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /phone-numbers","href":"/api-reference/phone-numbers/list-phone-numbers"}]},{"group":"Toll-Free Verifications","pages":[{"title":"List Toll-Free Verifications","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /toll-free-verifications","href":"/api-reference/toll-free-verifications/list-toll-free-verifications"},{"title":"Get Toll-Free Verification","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /toll-free-verifications/{id}","href":"/api-reference/toll-free-verifications/get-toll-free-verification"}]},{"group":"Brands","pages":[{"title":"List Brands","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /brands","href":"/api-reference/brands/list-brands"}]},{"group":"10DLC Campaigns","pages":[{"title":"List Campaigns","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /campaigns","href":"/api-reference/10dlc-campaigns/list-campaigns"},{"title":"Get Campaign Throughput","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /campaigns/{id}/throughput","href":"/api-reference/10dlc-campaigns/get-campaign-throughput"}]}]},{"group":"Email","pages":[{"group":"Email Campaigns","pages":[{"title":"List Campaigns","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /email/campaigns","href":"/api-reference/email-campaigns/list-campaigns"},{"title":"Create Campaign","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /email/campaigns","href":"/api-reference/email-campaigns/create-campaign"},{"title":"Get Campaign","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /email/campaigns/{id}","href":"/api-reference/email-campaigns/get-campaign"},{"title":"Schedule Campaign","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /email/campaigns/{id}/schedule","href":"/api-reference/email-campaigns/schedule-campaign"},{"title":"Unschedule Campaign","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /email/campaigns/{id}/unschedule","href":"/api-reference/email-campaigns/unschedule-campaign"},{"title":"Pause Campaign","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /email/campaigns/{id}/pause","href":"/api-reference/email-campaigns/pause-campaign"},{"title":"Resume Campaign","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /email/campaigns/{id}/resume","href":"/api-reference/email-campaigns/resume-campaign"},{"title":"End Campaign","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /email/campaigns/{id}/end","href":"/api-reference/email-campaigns/end-campaign"},{"title":"Add Recipient","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /email/campaigns/{id}/recipients","href":"/api-reference/email-campaigns/add-recipient"},{"title":"Create Hook URL","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /email/campaigns/{id}/hook","href":"/api-reference/email-campaigns/create-hook-url"},{"title":"Get Campaign Stats","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /email/campaigns/{id}/stats","href":"/api-reference/email-campaigns/get-campaign-stats"}]},{"group":"Email Templates","pages":[{"title":"List Email Templates","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /email/templates","href":"/api-reference/email-templates/list-email-templates"},{"title":"Create Email Template","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /email/templates","href":"/api-reference/email-templates/create-email-template"},{"title":"Get Email Template","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /email/templates/{id}","href":"/api-reference/email-templates/get-email-template"}]},{"group":"Email Senders","pages":[{"title":"List Sender Identities","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /email/senders","href":"/api-reference/email-senders/list-sender-identities"},{"title":"Get Sender Identity","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /email/senders/{id}","href":"/api-reference/email-senders/get-sender-identity"}]},{"group":"Email Suppressions","pages":[{"title":"List Suppressions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /email/suppressions","href":"/api-reference/email-suppressions/list-suppressions"},{"title":"Add Suppressions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /email/suppressions","href":"/api-reference/email-suppressions/add-suppressions"},{"title":"Remove Suppressions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /email/suppressions","href":"/api-reference/email-suppressions/remove-suppressions"}]}]},{"group":"Assets","pages":[{"group":"Contact Lists","pages":[{"title":"List Contact Lists","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /contact-lists","href":"/api-reference/contact-lists/list-contact-lists"},{"title":"Get Contact List","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /contact-lists/{id}","href":"/api-reference/contact-lists/get-contact-list"},{"title":"Delete Contact List","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /contact-lists/{id}","href":"/api-reference/contact-lists/delete-contact-list"},{"title":"Import List","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /contact-lists/import","href":"/api-reference/contact-lists/import-list"},{"title":"Analyze Contact List","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /contact-lists/{id}/analyze","href":"/api-reference/contact-lists/analyze-contact-list"},{"title":"Download Contact List CSV","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /contact-lists/{id}/download","href":"/api-reference/contact-lists/download-contact-list-csv"}]},{"group":"Tags","pages":[{"title":"List Tags","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /tags","href":"/api-reference/tags/list-tags"},{"title":"Add Contacts to Tag by Name","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /tags/contacts","href":"/api-reference/tags/add-contacts-to-tag-by-name"},{"title":"Remove Contacts from Tag by Name","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /tags/contacts","href":"/api-reference/tags/remove-contacts-from-tag-by-name"},{"title":"Create Tag","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /tags","href":"/api-reference/tags/create-tag"},{"title":"Rename Tag","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /tags/{id}","href":"/api-reference/tags/rename-tag"},{"title":"Delete Tag","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /tags/{id}","href":"/api-reference/tags/delete-tag"},{"title":"Add Contacts to Tag","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /tags/{id}/contacts","href":"/api-reference/tags/add-contacts-to-tag"},{"title":"Remove Contacts from Tag","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /tags/{id}/contacts","href":"/api-reference/tags/remove-contacts-from-tag"}]},{"group":"Media Files","pages":[{"title":"List Media Files","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /media","href":"/api-reference/media-files/list-media-files"},{"title":"Import Media","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /media","href":"/api-reference/media-files/import-media"},{"title":"Get Media File","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /media/{id}","href":"/api-reference/media-files/get-media-file"},{"title":"Delete Media File","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /media/{id}","href":"/api-reference/media-files/delete-media-file"}]}]},{"group":"Billing \u0026 Usage","pages":[{"group":"Billing","pages":[{"title":"Get Usage","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /ledger/usage","href":"/api-reference/billing/get-usage"},{"title":"Get Usage by Initiator","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /ledger/usage/by-initiator","href":"/api-reference/billing/get-usage-by-initiator"}]},{"group":"Analytics","pages":[{"title":"Get Message Stats","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /messages/stats","href":"/api-reference/analytics/get-message-stats"}]}]},{"group":"Admin","pages":[{"group":"Sending Domains","pages":[{"title":"List Sending Domains","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /email/domains","href":"/api-reference/sending-domains/list-sending-domains"},{"title":"Get Sending Domain","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /email/domains/{id}","href":"/api-reference/sending-domains/get-sending-domain"}]},{"group":"Tracking Domains","pages":[{"title":"List Tracking Domains","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /tracking-domains","href":"/api-reference/tracking-domains/list-tracking-domains"}]},{"group":"Webhook Endpoints","pages":[{"title":"List Webhook Endpoints","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /webhook-endpoints","href":"/api-reference/webhook-endpoints/list-webhook-endpoints"},{"title":"Get Webhook Endpoint","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /webhook-endpoints/{id}","href":"/api-reference/webhook-endpoints/get-webhook-endpoint"}]},{"group":"Organizations","pages":[{"title":"List Organizations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /organizations","href":"/api-reference/organizations/list-organizations"},{"title":"Get Hierarchy","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /hierarchy","href":"/api-reference/organizations/get-hierarchy"}]}]}]}]}]},"basePath":"","title":"Add Recipient - Political Comms","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-jJHA3WSo.js","utils-DbZn3Mjn.js","cloneDeep-CnBnaSyy.js","_Uint8Array-CMQtTgBR.js","isObject-FP1Yky1u.js","utils-Bl2DvzOJ.js","addUniqueKeysToSchema-BwOLo9p1.js","snippetPresets-BBiPpKa-.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-C0px4Tml.js","isEqual-zAyttAAO.js","usePlaygroundInputsStore-Dell6dGw.js","shallow-0VKqkSqN.js","getApiPlaygroundDisplay-CP_ctPEB.js","CodeSnippet-5L35ic0s.js","CodeSnippets-DOXbNhJw.js","Page-DRLI_2Ue.js","getPastedJson-VhzT9m2P.js","icon-CD8_AtCO.js","MethodPill-DGgOMftG.js","DuplicateIcon-DZ6A_EtN.js","createIcon-DUl4oM5f.js","DynamicMarkdown-BGHukeRM.js","SectionHeading-ChrEUs8u.js","axios-vUo_bRtp.js","Markdown-Dj-na-_-.js","dist-C5gjFYHe.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-DEBW87tT.js"]}