When someone clicks the unsubscribe link in an email, Shipstar marks them unsubscribed and no upsert, add or restore ever changes that row again — a bulk sync must never be able to undo an opt-out by accident. Two things can: the person clicking Resubscribe on the unsubscribe confirmation page, and this call, which records an opt-in the signed-in person made in your product (turning a “Product updates” switch back on, re-ticking a newsletter box).It is deliberately different from an upsert: one recipient per call, and a consent block that says where and when the person opted in. That block is stored on the recipient as its consent record and returned on every recipient read, so you can show your auditors who opted in, how and when.What happens, by the recipient’s current status:
Added as active; a hashed opt-out left by an erase is cleared
added
mailing_list.resubscribed if a hash was cleared
removed (you took them off)
Active again
reactivated
—
active
Nothing to change; name, attributes and the consent record are still applied
already_active
—
Matching is by external_id first, then by email. Sending a new email for an existing external_id changes the address in place (and rotates that person’s unsubscribe link). Activating a recipient counts against the list’s plan cap exactly like an upsert.
Call this from the code path where the person flips the switch, not from your nightly sync. Your sync should keep using upsert and treat skipped_unsubscribed as the person’s final word until they opt in again — and should subscribe to the mailing_list.resubscribed webhook so an opt-in made on Shipstar’s confirmation page flips your own flag too. See Hearing about unsubscribes and resubscribes.
Authentication
This endpoint requires an API token passed as a Bearer token in the Authorization header.
Authorization: Bearer YOUR_API_TOKEN
Path Parameters
string
required
The mailing list’s unique identifier (UUID).
Body
At least one of email and external_id. Without an email, an unknown external_id is a 404 — there is nothing to add.
string
Your own id for this person, up to 255 characters. Matched first.
string
Email address (case-insensitive). Required to add someone who is not on the list; changes the address of an external_id-keyed recipient.
string
Display name, up to 200 characters. Applied when sent.
object
Up to 20 keys with string, number, boolean or null values; replaces the stored map when sent.
object
required
Where and when the person opted in on your side.
Show Consent object
string
required
Where they opted in, in your words — e.g. Product updates switch, account settings. Up to 200 characters.
string
When they did it (ISO 8601). Defaults to now.
string
Their IP address at the time, if you have it.
string
Their browser user agent at the time, if you have it.
Error bodies carry a stable code next to the human-readable detail.
Status
code
Meaning
400
recipient_cap_exceeded
Activating this recipient would exceed the list’s plan cap; the body also has active_count, limit and incoming
401
—
Invalid or expired API token
404
—
Mailing list not found in the token’s project
404
recipient_not_found
external_id only, and nobody on the list has it
409
external_id_conflict
The email belongs to a recipient with a different external_id
409
email_conflict
The new email is already another recipient’s address on this list
422
invalid_email
The email address failed validation
422
—
Invalid request body (no identifier, missing consent.source, oversize attributes)
Rate Limits
This endpoint is limited to 30 requests per minute per IP.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Shipstar","colors":{"primary":"#007A47","light":"#00DC82","dark":"#006B3E"},"logo":{"light":"https://mintcdn.com/shipstar/UUkwwvdaEj90vqzY/logo/light.svg?fit=max\u0026auto=format\u0026n=UUkwwvdaEj90vqzY\u0026q=85\u0026s=923f84c33cd78fd3d3a496de8807d26c","dark":"https://mintcdn.com/shipstar/UUkwwvdaEj90vqzY/logo/dark.svg?fit=max\u0026auto=format\u0026n=UUkwwvdaEj90vqzY\u0026q=85\u0026s=d102097ae3dc99b0e4840e1061e18577"},"favicon":"https://mintcdn.com/shipstar/UUkwwvdaEj90vqzY/favicon.svg?fit=max\u0026auto=format\u0026n=UUkwwvdaEj90vqzY\u0026q=85\u0026s=13a86f14950ba998ce023837c3f01003","api":{},"appearance":{"default":"dark"},"navbar":{"links":[{"href":"https://app.shipstar.ai","label":"Dashboard"}],"primary":{"type":"button","label":"Get API Key","href":"https://app.shipstar.ai/dashboard"}},"footer":{"socials":{"x":"https://twitter.com/shipstarai","github":"https://github.com/shipstar"}},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"shipstar","hasAudioNarration":false,"actualSubdomain":"shipstar","customDomains":["docs.shipstar.ai"],"gitSource":{"type":"github","owner":"turbo-labs","repo":"shipstar-ai","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6af7ea98d68a94726960030c","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"MCP Services","count":39},{"language":"default","tag":"API Reference","count":29},{"language":"default","tag":"Documentation","count":11},{"language":"default","tag":"Mailing Lists","count":10},{"language":"default","tag":"Generation Tools","count":10},{"language":"default","tag":"Project \u0026 Delivery Tools","count":8},{"language":"default","tag":"Get Started","count":7},{"language":"default","tag":"Agent Skills","count":7},{"language":"default","tag":"Guides","count":6},{"language":"default","tag":"Lifecycle Tools","count":5}]},"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":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"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/mailing-lists/resubscribe-recipient","slug":"/api-reference/mailing-lists/resubscribe-recipient","pageMetadata":{"title":"Resubscribe Recipient","api":"POST /email/lists/{list_id}/recipients/resubscribe","description":"Record an explicit opt-in the person made in your app — the only call that undoes an unsubscribe","href":"/api-reference/mailing-lists/resubscribe-recipient"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Record an explicit opt-in the person made in your app — the only call that undoes an unsubscribe\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Expandable,Heading,ParamField,ResponseField,Table,Tip}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`When someone clicks the unsubscribe link in an email, Shipstar marks them `,_jsx(_components.code,{children:`unsubscribed`}),` and no `,_jsx(_components.a,{href:`/api-reference/mailing-lists/upsert-recipients`,children:`upsert`}),`, add or restore ever changes that row again — a bulk sync must never be able to undo an opt-out by accident. Two things can: the person clicking `,_jsx(_components.strong,{children:`Resubscribe`}),` on the unsubscribe confirmation page, and this call, which records an opt-in the signed-in person made in `,_jsx(_components.em,{children:`your`}),` product (turning a “Product updates” switch back on, re-ticking a newsletter box).`]}),`\n`,_jsxs(_components.p,{children:[`It is deliberately different from an upsert: one recipient per call, and a `,_jsx(_components.code,{children:`consent`}),` block that says where and when the person opted in. That block is stored on the recipient as its `,_jsx(_components.code,{children:`consent`}),` record and returned on every recipient read, so you can show your auditors who opted in, how and when.`]}),`\n`,_jsx(_components.p,{children:`What happens, by the recipient’s current status:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status before`}),_jsx(_components.th,{children:`Result`}),_jsxs(_components.th,{children:[_jsx(_components.code,{children:`status`}),` in the response`]}),_jsx(_components.th,{children:`Webhook`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`unsubscribed`})}),_jsx(_components.td,{children:`Active again`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`resubscribed`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`mailing_list.resubscribed`})})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Not on the list, or `,_jsx(_components.a,{href:`/api-reference/mailing-lists/erase-recipients`,children:`erased`}),` earlier`]}),_jsx(_components.td,{children:`Added as active; a hashed opt-out left by an erase is cleared`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`added`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`mailing_list.resubscribed`}),` if a hash was cleared`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`removed`}),` (you took them off)`]}),_jsx(_components.td,{children:`Active again`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`reactivated`})}),_jsx(_components.td,{children:`—`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`active`})}),_jsxs(_components.td,{children:[`Nothing to change; `,_jsx(_components.code,{children:`name`}),`, `,_jsx(_components.code,{children:`attributes`}),` and the consent record are still applied`]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`already_active`})}),_jsx(_components.td,{children:`—`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Matching is by `,_jsx(_components.code,{children:`external_id`}),` first, then by email. Sending a new `,_jsx(_components.code,{children:`email`}),` for an existing `,_jsx(_components.code,{children:`external_id`}),` changes the address in place (and rotates that person’s unsubscribe link). Activating a recipient counts against the list’s plan cap exactly like an upsert.`]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Call this from the code path where the person flips the switch, not from your nightly sync. Your sync should keep using upsert and treat `,_jsx(_components.code,{children:`skipped_unsubscribed`}),` as the person’s final word until they opt in again — and should subscribe to the `,_jsx(_components.code,{children:`mailing_list.resubscribed`}),` webhook so an opt-in made on Shipstar’s confirmation page flips your own flag too. See `,_jsx(_components.a,{href:`/guides/sync-mailing-list#hearing-about-unsubscribes-and-resubscribes`,children:`Hearing about unsubscribes and resubscribes`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`authentication`,children:`Authentication`}),`\n`,_jsxs(_components.p,{children:[`This endpoint requires an API token passed as a Bearer token in the `,_jsx(_components.code,{children:`Authorization`}),` header.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`Authorization:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` Bearer`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` YOUR_API_TOKEN`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`path-parameters`,children:`Path Parameters`}),`\n`,_jsx(ParamField,{path:`list_id`,type:`string`,required:true,id:`param-list-id`,children:_jsx(_components.p,{children:`The mailing list’s unique identifier (UUID).`})}),`\n`,_jsx(Heading,{level:`2`,id:`body`,children:`Body`}),`\n`,_jsxs(_components.p,{children:[`At least one of `,_jsx(_components.code,{children:`email`}),` and `,_jsx(_components.code,{children:`external_id`}),`. Without an `,_jsx(_components.code,{children:`email`}),`, an unknown `,_jsx(_components.code,{children:`external_id`}),` is a 404 — there is nothing to add.`]}),`\n`,_jsx(ParamField,{body:`external_id`,type:`string`,id:`param-external-id`,children:`Your own id for this person, up to 255 characters. Matched first.`}),`\n`,_jsxs(ParamField,{body:`email`,type:`string`,id:`param-email`,children:[`Email address (case-insensitive). Required to add someone who is not on the list; changes the address of an `,_jsx(_components.code,{children:`external_id`}),`-keyed recipient.`]}),`\n`,_jsx(ParamField,{body:`name`,type:`string`,id:`param-name`,children:`Display name, up to 200 characters. Applied when sent.`}),`\n`,_jsx(ParamField,{body:`attributes`,type:`object`,id:`param-attributes`,children:`Up to 20 keys with string, number, boolean or null values; replaces the stored map when sent.`}),`\n`,_jsxs(ParamField,{body:`consent`,type:`object`,required:true,id:`param-consent`,children:[_jsx(_components.p,{children:`Where and when the person opted in on your side.`}),_jsxs(Expandable,{title:`Consent object`,children:[_jsxs(ParamField,{body:`source`,type:`string`,required:true,id:`param-source`,children:[`Where they opted in, in your words — e.g. `,_jsx(_components.code,{children:`Product updates switch, account settings`}),`. Up to 200 characters.`]}),_jsx(ParamField,{body:`recorded_at`,type:`string`,id:`param-recorded-at`,children:`When they did it (ISO 8601). Defaults to now.`}),_jsx(ParamField,{body:`ip`,type:`string`,id:`param-ip`,children:`Their IP address at the time, if you have it.`}),_jsx(ParamField,{body:`user_agent`,type:`string`,id:`param-user-agent`,children:`Their browser user agent at the time, if you have it.`})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`request`,children:`Request`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`13`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`13`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.shipstar.ai/api/v1/email/lists/a1b2c3d4-e5f6-7890-abcd-ef1234567890/recipients/resubscribe\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer YOUR_API_TOKEN\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"external_id\": \"usr_42\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"email\": \"sam@example.com\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"consent\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"source\": \"Product updates switch, account settings\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"recorded_at\": \"2026-11-13T17:06:12Z\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"ip\": \"203.0.113.5\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"user_agent\": \"Mozilla/5.0\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`JavaScript`,numberOfLines:`20`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`20`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` listId`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'a1b2c3d4-e5f6-7890-abcd-ef1234567890'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` response`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` fetch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`https://api.shipstar.ai/api/v1/email/lists/\"}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`listId`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"/recipients/resubscribe`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` method:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'POST'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` headers:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Authorization'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Bearer YOUR_API_TOKEN'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Content-Type'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'application/json'`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` body:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` JSON`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`stringify`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` external_id:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'usr_42'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` email:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'sam@example.com'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` consent:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` source:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Product updates switch, account settings'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` recorded_at:`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` new`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` Date`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`().`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`toISOString`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(),`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` ip:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` request`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`ip`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` user_agent:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` request`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`headers`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'user-agent'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` })`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` result`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` response`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`json`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`20`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`20`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` datetime `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` datetime, timezone`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`list_id `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'a1b2c3d4-e5f6-7890-abcd-ef1234567890'`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`response `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests.post(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` f`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'https://api.shipstar.ai/api/v1/email/lists/`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`list_id`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`/recipients/resubscribe'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` headers`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Authorization'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Bearer YOUR_API_TOKEN'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`},`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` json`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'external_id'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'usr_42'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'email'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'sam@example.com'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'consent'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'source'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Product updates switch, account settings'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'recorded_at'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: datetime.now(timezone.utc).isoformat(),`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'ip'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: request.client.host,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'user_agent'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: request.headers.get(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'user-agent'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`),`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`result `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` response.json()`})]}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(ResponseField,{name:`status`,type:`string`,required:true,id:`param-status`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`resubscribed`}),`, `,_jsx(_components.code,{children:`added`}),`, `,_jsx(_components.code,{children:`reactivated`}),` or `,_jsx(_components.code,{children:`already_active`}),` — see the table above.`]})}),`\n`,_jsxs(ResponseField,{name:`recipient`,type:`object`,required:true,id:`param-recipient`,children:[_jsxs(_components.p,{children:[`The recipient as `,_jsx(_components.a,{href:`/api-reference/mailing-lists/list-recipients`,children:`List Recipients`}),` returns it, now `,_jsx(_components.code,{children:`active`}),`, including the `,_jsx(_components.code,{children:`consent`}),` record just written:`]}),_jsxs(Expandable,{title:`consent`,children:[_jsxs(ResponseField,{name:`via`,type:`string`,required:true,id:`param-via`,children:[_jsx(_components.code,{children:`api`}),` for this call; `,_jsx(_components.code,{children:`email_link`}),` when the person used the button on the unsubscribe page`]}),_jsxs(ResponseField,{name:`source`,type:`string`,required:true,id:`param-source-1`,children:[`Your `,_jsx(_components.code,{children:`consent.source`}),`, or `,_jsx(_components.code,{children:`unsubscribe_page`})]}),_jsx(ResponseField,{name:`recorded_at`,type:`string`,required:true,id:`param-recorded-at-1`,children:`ISO 8601`}),_jsx(ResponseField,{name:`ip`,type:`string`,id:`param-ip-1`,children:`As sent, or the visitor’s address on the unsubscribe page`}),_jsx(ResponseField,{name:`user_agent`,type:`string`,id:`param-user-agent-1`,children:`As sent, or the visitor’s browser on the unsubscribe page`})]})]}),`\n`,_jsx(CodeBlock,{filename:`200`,numberOfLines:`22`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`22`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"resubscribed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"recipient\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"5b2f8c1e-4d3a-4f6b-9e2d-1a2b3c4d5e6f\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"email\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"sam@example.com\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Sam Lee\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"external_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"usr_42\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"attributes\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"plan\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"pro\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`},`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"active\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status_changed_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-11-13T17:06:13Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"consent\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"via\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"api\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"source\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Product updates switch, account settings\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"recorded_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-11-13T17:06:12Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"ip\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"203.0.113.5\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"user_agent\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Mozilla/5.0\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"is_active\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"created_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-09-01T08:00:00Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"updated_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-11-13T17:06:13Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`errors`,children:`Errors`}),`\n`,_jsxs(_components.p,{children:[`Error bodies carry a stable `,_jsx(_components.code,{children:`code`}),` next to the human-readable `,_jsx(_components.code,{children:`detail`}),`.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:_jsx(_components.code,{children:`code`})}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`recipient_cap_exceeded`})}),_jsxs(_components.td,{children:[`Activating this recipient would exceed the list’s plan cap; the body also has `,_jsx(_components.code,{children:`active_count`}),`, `,_jsx(_components.code,{children:`limit`}),` and `,_jsx(_components.code,{children:`incoming`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`401`}),_jsx(_components.td,{children:`—`}),_jsx(_components.td,{children:`Invalid or expired API token`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`404`}),_jsx(_components.td,{children:`—`}),_jsx(_components.td,{children:`Mailing list not found in the token’s project`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`404`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`recipient_not_found`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`external_id`}),` only, and nobody on the list has it`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`external_id_conflict`})}),_jsxs(_components.td,{children:[`The email belongs to a recipient with a different `,_jsx(_components.code,{children:`external_id`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`email_conflict`})}),_jsx(_components.td,{children:`The new email is already another recipient’s address on this list`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`422`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`invalid_email`})}),_jsx(_components.td,{children:`The email address failed validation`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`422`}),_jsx(_components.td,{children:`—`}),_jsxs(_components.td,{children:[`Invalid request body (no identifier, missing `,_jsx(_components.code,{children:`consent.source`}),`, oversize attributes)`]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`rate-limits`,children:`Rate Limits`}),`\n`,_jsx(_components.p,{children:`This endpoint is limited to 30 requests per minute per IP.`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Resubscribe Recipient","api":"POST /email/lists/{list_id}/recipients/resubscribe","description":"Record an explicit opt-in the person made in your app — the only call that undoes an unsubscribe","href":"/api-reference/mailing-lists/resubscribe-recipient"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Authentication","slug":"authentication","depth":2,"children":[]},{"title":"Path Parameters","slug":"path-parameters","depth":2,"children":[]},{"title":"Body","slug":"body","depth":2,"children":[]},{"title":"Request","slug":"request","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[]},{"title":"Errors","slug":"errors","depth":2,"children":[]},{"title":"Rate Limits","slug":"rate-limits","depth":2,"children":[]}],"codeExamples":{},"endpoint":{"title":"Resubscribe Recipient","path":"/email/lists/{list_id}/recipients/resubscribe","method":"post","request":{"security":[],"parameters":{"query":{},"header":{},"cookie":{},"path":{"list_id":{"schema":[{"type":"string","description":"The mailing list’s unique identifier (UUID).","required":true}]}}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"external_id":[{"type":"string","description":"Your own id for this person, up to 255 characters. Matched first."}],"email":[{"type":"string","description":"Email address (case-insensitive). Required to add someone who is not on the list; changes the address of an `external_id` -keyed recipient."}],"name":[{"type":"string","description":"Display name, up to 200 characters. Applied when sent."}],"attributes":[{"type":"object","properties":{},"description":"Up to 20 keys with string, number, boolean or null values; replaces the stored map when sent."}],"consent":[{"type":"object","properties":{"source":[{"type":"string","description":"Where they opted in, in your words — e.g. `Product updates switch, account settings` . Up to 200 characters.","required":true}],"recorded_at":[{"type":"string","description":"When they did it (ISO 8601). Defaults to now."}],"ip":[{"type":"string","description":"Their IP address at the time, if you have it."}],"user_agent":[{"type":"string","description":"Their browser user agent at the time, if you have it."}]},"description":"Where and when the person opted in on your side.","required":true}]}}],"examples":{"example":{"value":{"external_id":"\u003cstring>","email":"\u003cstring>","name":"\u003cstring>","attributes":{},"consent":{"source":"\u003cstring>","recorded_at":"\u003cstring>","ip":"\u003cstring>","user_agent":"\u003cstring>"}}}}}}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"status":[{"type":"string","description":"`resubscribed` , `added` , `reactivated` or `already_active` — see the table above.","required":true}],"recipient":[{"type":"object","properties":{"via":[{"type":"string","description":"`api` for this call; `email_link` when the person used the button on the unsubscribe page","required":true}],"source":[{"type":"string","description":"Your `consent.source` , or `unsubscribe_page`","required":true}],"recorded_at":[{"type":"string","description":"ISO 8601","required":true}],"ip":[{"type":"string","description":"As sent, or the visitor’s address on the unsubscribe page"}],"user_agent":[{"type":"string","description":"As sent, or the visitor’s browser on the unsubscribe page"}]},"description":"The recipient as List Recipients returns it, now `active` , including the `consent` record just written:","required":true}]}}],"examples":{"example":{"value":{"status":"\u003cstring>","recipient":{"via":"\u003cstring>","source":"\u003cstring>","recorded_at":"\u003cstring>","ip":"\u003cstring>","user_agent":"\u003cstring>"}}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"shipstar","siteName":"Shipstar","title":"Resubscribe Recipient - Shipstar","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-09T18:52:14.428Z","originalFileLocation":"api-reference/mailing-lists/resubscribe-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=\"dark\"}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=\"Record an explicit opt-in the person made in your app — the only call that undoes an unsubscribe\">\u003cmeta data-mint-head name=\"application-name\" content=\"Shipstar\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/shipstar/sv7TW8CmKuFRAxza/_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/shipstar/sv7TW8CmKuFRAxza/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/shipstar/sv7TW8CmKuFRAxza/_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/shipstar/sv7TW8CmKuFRAxza/_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/shipstar/sv7TW8CmKuFRAxza/_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/shipstar/sv7TW8CmKuFRAxza/_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/shipstar/sv7TW8CmKuFRAxza/_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/shipstar/sv7TW8CmKuFRAxza/_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/shipstar/sv7TW8CmKuFRAxza/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Resubscribe Recipient - Shipstar\">\u003cmeta data-mint-head property=\"og:description\" content=\"Record an explicit opt-in the person made in your app — the only call that undoes an unsubscribe\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Shipstar\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.shipstar.ai/api-reference/mailing-lists/resubscribe-recipient\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://shipstar.mintlify.site/_mintlify/api/og/v2?division=Mailing+Lists\u0026amp;title=Resubscribe+Recipient\u0026amp;description=Record+an+explicit+opt-in+the+person+made+in+your+app+%E2%80%94+the+only+call+that+undoes+an+unsubscribe\u0026amp;theme=db1c0867b3dbc92d03394e47\u0026amp;signature=407a91ff691443e3f61bf602bbd2732c8ca29f0e6336e8143d1768b3bc583780\">\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=\"Resubscribe Recipient - Shipstar\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Record an explicit opt-in the person made in your app — the only call that undoes an unsubscribe\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://shipstar.mintlify.site/_mintlify/api/og/v2?division=Mailing+Lists\u0026amp;title=Resubscribe+Recipient\u0026amp;description=Record+an+explicit+opt-in+the+person+made+in+your+app+%E2%80%94+the+only+call+that+undoes+an+unsubscribe\u0026amp;theme=db1c0867b3dbc92d03394e47\u0026amp;signature=407a91ff691443e3f61bf602bbd2732c8ca29f0e6336e8143d1768b3bc583780\">\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/shipstar/sv7TW8CmKuFRAxza/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Shipstar\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#007A47\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.shipstar.ai/api-reference/mailing-lists/resubscribe-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/mailing-lists/resubscribe-recipient.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.shipstar.ai/#organization\",\"name\":\"Shipstar\",\"url\":\"https://docs.shipstar.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/shipstar/UUkwwvdaEj90vqzY/logo/light.svg?fit=max\u0026auto=format\u0026n=UUkwwvdaEj90vqzY\u0026q=85\u0026s=923f84c33cd78fd3d3a496de8807d26c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.shipstar.ai#website\",\"name\":\"Shipstar\",\"url\":\"https://docs.shipstar.ai\",\"publisher\":{\"@id\":\"https://docs.shipstar.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.shipstar.ai/api-reference/mailing-lists/resubscribe-recipient#webpage\",\"url\":\"https://docs.shipstar.ai/api-reference/mailing-lists/resubscribe-recipient\",\"name\":\"Resubscribe Recipient\",\"description\":\"Record an explicit opt-in the person made in your app — the only call that undoes an unsubscribe\",\"dateModified\":\"2026-11-09T18:52:14.428Z\",\"isPartOf\":{\"@id\":\"https://docs.shipstar.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.shipstar.ai/api-reference/mailing-lists/resubscribe-recipient#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.shipstar.ai/api-reference/mailing-lists/resubscribe-recipient#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Mailing Lists\",\"item\":\"https://docs.shipstar.ai/api-reference/mailing-lists/list-mailing-lists\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Resubscribe Recipient\",\"item\":\"https://docs.shipstar.ai/api-reference/mailing-lists/resubscribe-recipient\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.shipstar.ai/api-reference/mailing-lists/resubscribe-recipient#apireference\",\"headline\":\"Resubscribe Recipient\",\"name\":\"Resubscribe Recipient\",\"description\":\"Record an explicit opt-in the person made in your app — the only call that undoes an unsubscribe\",\"url\":\"https://docs.shipstar.ai/api-reference/mailing-lists/resubscribe-recipient\",\"mainEntityOfPage\":{\"@id\":\"https://docs.shipstar.ai/api-reference/mailing-lists/resubscribe-recipient#webpage\"},\"dateModified\":\"2026-11-09T18:52:14.428Z\",\"publisher\":{\"@id\":\"https://docs.shipstar.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.shipstar.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Shipstar\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Shipstar\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/mailing-lists/resubscribe-recipient.md","siteName":"Shipstar","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"MCP Services","pages":[{"title":"MCP Services","href":"/mcp/overview"}]},{"tab":"API Reference","groups":[{"group":"API Reference","pages":[{"title":"Shipstar API Overview","href":"/api-reference/overview"},{"title":"Health Check","api":"GET /health","href":"/api-reference/health"},{"title":"Get Current User","api":"GET /me","href":"/api-reference/authentication"},{"title":"Shipstar API Versioning \u0026 Deprecation Policy","href":"/api-reference/versioning"}]},{"group":"Changelog","pages":[{"title":"List Published Changelogs","api":"GET /changelogs","href":"/api-reference/changelog/list-changelogs"},{"title":"Get Public Changelog","api":"GET /changelog/{public_slug}","href":"/api-reference/changelog/get-changelog"},{"title":"Get Changelog RSS Feed","api":"GET /changelog/{public_slug}/feed","href":"/api-reference/changelog/changelog-feed"}]},{"group":"Blog","pages":[{"title":"List Published Blog Posts","api":"GET /blogs","href":"/api-reference/blog/list-blog-posts"},{"title":"Get Public Blog Post","api":"GET /blog/{public_slug}","href":"/api-reference/blog/get-blog-post"},{"title":"Get Blog Post RSS Feed","api":"GET /blog/{public_slug}/feed","href":"/api-reference/blog/blog-post-feed"},{"title":"Get All Blogs RSS Feed","api":"GET /blogs/feed","href":"/api-reference/blog/all-blogs-feed"}]},{"group":"Knowledge Base","pages":[{"title":"List Published KB Articles","api":"GET /kb","href":"/api-reference/kb/list-kb-articles"},{"title":"Get Public KB Articles","api":"GET /kb/{public_slug}","href":"/api-reference/kb/get-kb-articles"}]},{"group":"Banner","pages":[{"title":"Get Live Banner","api":"GET /banner","href":"/api-reference/banner/get-live-banner"},{"title":"Get Banner by Slug","api":"GET /banner/{public_slug}","href":"/api-reference/banner/get-banner"}]},{"group":"Mailing Lists","pages":[{"title":"List Mailing Lists","api":"GET /email/lists","href":"/api-reference/mailing-lists/list-mailing-lists"},{"title":"Create Mailing List","api":"POST /email/lists","href":"/api-reference/mailing-lists/create-mailing-list"},{"title":"Get Mailing List","api":"GET /email/lists/{list_id}","href":"/api-reference/mailing-lists/get-mailing-list"},{"title":"List Recipients","api":"GET /email/lists/{list_id}/recipients","href":"/api-reference/mailing-lists/list-recipients"},{"title":"Upsert Recipients","api":"PUT /email/lists/{list_id}/recipients","href":"/api-reference/mailing-lists/upsert-recipients"},{"title":"Add Recipients","api":"POST /email/lists/{list_id}/recipients","href":"/api-reference/mailing-lists/add-recipients"},{"title":"Remove Recipients","api":"DELETE /email/lists/{list_id}/recipients/{identifier}","description":"Take one recipient (or a batch) off a list without erasing their opt-out history","href":"/api-reference/mailing-lists/remove-recipient"},{"title":"Resubscribe Recipient","api":"POST /email/lists/{list_id}/recipients/resubscribe","href":"/api-reference/mailing-lists/resubscribe-recipient"},{"title":"Erase Recipients","api":"POST /email/lists/{list_id}/recipients/erase","description":"Permanently delete recipients — for when one of your users asks to be forgotten","href":"/api-reference/mailing-lists/erase-recipients"},{"title":"Export Recipients","api":"GET /email/lists/{list_id}/recipients/export.csv","href":"/api-reference/mailing-lists/export-recipients"}]}]}]},"basePath":"","title":"Resubscribe Recipient - Shipstar","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-B6WFFOBL.js","utils-BN5um1KA.js","cloneDeep-C3md22mN.js","_Uint8Array-DLlL8L26.js","isObject-FP1Yky1u.js","utils-BSmbkXJR.js","addUniqueKeysToSchema-2tqcVnUE.js","snippetPresets-CtWfvr2J.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-DkKHBy30.js","isEqual-O3q7y6pq.js","usePlaygroundInputsStore-Brc5H9UJ.js","shallow-C4L4xvbs.js","getApiPlaygroundDisplay-2bxyq_aI.js","CodeSnippet-BJu8ddd5.js","CodeSnippets-dazWmoqB.js","Page-CnLhKuUV.js","getPastedJson-Chy3Qa1S.js","icon-CyO7h3jh.js","MethodPill-Dle0_91v.js","DuplicateIcon-CVvWAf4a.js","createIcon-Di07A27B.js","DynamicMarkdown-C4w9kavL.js","SectionHeading-XiBebVYC.js","axios-vUo_bRtp.js"]}