POST /api/v1/locations - send a one-time location pin.
Sends a one-time location pin to a phone number when location sharing is enabled on the selected sender line.
This is not Find My or ongoing Live Location sharing. It sends one fixed latitude/longitude. The recipient cannot follow movement from this endpoint.
Use this when you already have coordinates and want the recipient to receive a Maps-style location card when their sender line supports it. On the newer location-card-enabled lines, auto selects the card path and a failure does not automatically send a URL. Choose geo_url explicitly for URL-only delivery. Other enabled lines can retain their existing auto fallback behavior. If the selected sender line does not support location sends, Chert returns 4099.
The existing native location-card rollout is enabled on selected lines. It
requires phone in E.164 form, an existing direct iMessage chat belonging to the
sender, and a nonempty idempotency_key up to 128 characters. Groups, email
recipients, chat_id, custom url, and vcard are not supported on this path.An accepted request returns 202 with message_id, status, delivery,
location, and status_url. Read the returned status_url
(GET /api/v1/locations/{message_id}) with the same authentication to inspect
recorded queued/acknowledged/sent/delivered evidence. Acceptance or acknowledgement
is not recipient rendering. This status route applies to the enabled card path;
do not assume every older location response includes it.Preserve the same key and original request. A changed key creates another send.
After an uncertain result or retryable: false, reconcile before sending again;
do not automatically downgrade a requested card to a URL.
Advanced chat routing — other enabled lines
Use this section only when Chert confirms the line supports this legacy routing.
Location-card-enabled lines reject chat_id. Most callers should send by phone. chat_id is only for Chert-provided delivery chat ids; it is not the UUID returned by POST /api/v1/chats.
202 means the location request was accepted by the sender line. The final recipient UI is device-dependent: supported iMessage clients may render a map card; fallback clients receive a tappable Apple Maps URL.
Fields
Field
Required
Notes
phone
Yes, unless chat_id is set
Recipient in E.164 format. Pass either phone or chat_id, not both.
chat_id
Yes, unless phone is set
Chert-provided delivery chat id. This is not the public UUID returned by /api/v1/chats. Pass either chat_id or phone, not both.
latitude
Yes
Number from -90 to 90.
longitude
Yes
Number from -180 to 180.
label
No
Place name shown in the card or text fallback.
address
No
Secondary place text.
url
No
Unsupported on the native card path. Otherwise omit unless Chert confirms support.
fallback_mode
No
Native card path: auto selects a card without automatic URL fallback; balloon requests a card; geo_url explicitly requests URL text. vcard is unsupported.
expires_at
No
Stored and echoed for your own bookkeeping. It does not create an ongoing or expiring Live Location share on the recipient device.
phone_line_id
No
Use a specific assigned sender line. Most callers should omit this.
idempotency_key
Required for the native card path
Nonempty, up to 128 characters on that path. Preserve the same key and request; do not retry uncertain outcomes automatically.
external_id
No
Your application record id.
Common errors
Code
When
1001
Missing phone/chat_id, or missing coordinates.
1002
Both phone and chat_id were passed, or coordinates are out of range.
3002
No eligible sender line is available for location sharing.
4001
The sender line accepted the request but delivery failed downstream.
4099
Location sharing is not available on the selected sender line, or the requested mode is unsupported.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Chert","colors":{"primary":"#E84A10","light":"#FF6F3B","dark":"#E84A10"},"logo":{"light":"https://mintcdn.com/cherttechnologiesinc/jd3nvtW3TQewqkHo/logo/light.png?fit=max\u0026auto=format\u0026n=jd3nvtW3TQewqkHo\u0026q=85\u0026s=137a61b59b0a21d5afc0e14ca6e5c8f6","dark":"https://mintcdn.com/cherttechnologiesinc/jd3nvtW3TQewqkHo/logo/dark.png?fit=max\u0026auto=format\u0026n=jd3nvtW3TQewqkHo\u0026q=85\u0026s=3569955c68d7bc16e7d2690201e952d5","href":"https://trychert.com"},"favicon":"https://mintcdn.com/cherttechnologiesinc/7NuyCzLl8sIsJEKo/logo/favicon.png?fit=max\u0026auto=format\u0026n=7NuyCzLl8sIsJEKo\u0026q=85\u0026s=1082b59e7df48ee97e0670c53c5b947b","appearance":{"default":"light","strict":false},"navbar":{"primary":{"type":"button","label":"Get started","href":"https://app.trychert.com"}},"footer":{"socials":{"website":"https://trychert.com"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cherttechnologiesinc","hasAudioNarration":false,"actualSubdomain":"cherttechnologiesinc","customDomains":["docs.trychert.com"],"gitSource":{"type":"github","owner":"cherthq","repo":"chert-crm","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":false},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afcd3249a501c439f903c10","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"FaceTime","count":30},{"language":"default","tag":"Messaging API","count":29},{"language":"default","tag":"Integrations","count":18},{"language":"default","tag":"Reference","count":14},{"language":"default","tag":"FaceTime CLI","count":12},{"language":"default","tag":"Get started","count":11},{"language":"default","tag":"Messages","count":8},{"language":"default","tag":"Setup","count":7},{"language":"default","tag":"Salesforce","count":7},{"language":"default","tag":"Build with BYOR","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"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":[{"filePath":"styles.css","content":"@import url('https://api.fontshare.com/v2/css?f[]=general-sans@400,500,600,700\u0026display=swap');@import url('https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;600\u0026display=swap');:root{--font-sans: 'General Sans', -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;--font-mono: 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, monospace}html,body,button,input,select,textarea,.font-sans,[class*=\"text-\"],h1,h2,h3,h4,h5,h6,p,li,td,th,a,span,div{font-family:var(--font-sans)}code,pre,kbd,samp,.font-mono,[class*=\"font-mono\"],[class*=\"code\"] code{font-family:var(--font-mono)!important;font-variant-ligatures:none}h1,h2,h3,h4,h5,h6{letter-spacing:-0.01em}h1{letter-spacing:-0.02em}.prose :where(h2,h3){margin-top:1.35em;margin-bottom:0.55em}.prose :where(p,ul,ol,table,pre){margin-top:0.75em;margin-bottom:0.75em}.prose :where(li){margin-top:0.25em;margin-bottom:0.25em}.prose :where(.card,[class*=\"Card\"]){border-radius:8px}"}],"page":{"pagePath":"api/locations","slug":"/api/locations","pageMetadata":{"title":"Send a location","description":"POST /api/v1/locations - send a one-time location pin.","icon":"map-pin","href":"/api/locations"},"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: \"POST /api/v1/locations - send a one-time location pin.\"\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`,li:`li`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Sends a one-time location pin to a phone number when location sharing is enabled on the selected sender line.`}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`This is not Find My or ongoing Live Location sharing. It sends one fixed latitude/longitude. The recipient cannot follow movement from this endpoint.`})}),`\n`,_jsxs(_components.p,{children:[`Use this when you already have coordinates and want the recipient to receive a Maps-style location card when their sender line supports it. On the newer location-card-enabled lines, `,_jsx(_components.code,{children:`auto`}),` selects the card path and a failure does not automatically send a URL. Choose `,_jsx(_components.code,{children:`geo_url`}),` explicitly for URL-only delivery. Other enabled lines can retain their existing `,_jsx(_components.code,{children:`auto`}),` fallback behavior. If the selected sender line does not support location sends, Chert returns `,_jsx(_components.code,{children:`4099`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`request`,children:`Request`}),`\n`,_jsx(CodeBlock,{filename:``,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://console.trychert.com/api/v1/locations`}),_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 `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$CHERT_SIGNING_SECRET`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_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:` \"phone\": \"+14155551234\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"latitude\": 40.758896,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"longitude\": -73.985130,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"label\": \"Times Square\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"address\": \"Manhattan, NY\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"fallback_mode\": \"auto\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"expires_at\": \"2026-06-02T23:00:00Z\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"idempotency_key\": \"loc-2026-06-02-001\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`location-card-enabled-lines`,children:`Location-card-enabled lines`}),`\n`,_jsxs(_components.p,{children:[`The existing native location-card rollout is enabled on selected lines. It\nrequires `,_jsx(_components.code,{children:`phone`}),` in E.164 form, an existing direct iMessage chat belonging to the\nsender, and a nonempty `,_jsx(_components.code,{children:`idempotency_key`}),` up to 128 characters. Groups, email\nrecipients, `,_jsx(_components.code,{children:`chat_id`}),`, custom `,_jsx(_components.code,{children:`url`}),`, and `,_jsx(_components.code,{children:`vcard`}),` are not supported on this path.`]}),`\n`,_jsxs(_components.p,{children:[`An accepted request returns `,_jsx(_components.code,{children:`202`}),` with `,_jsx(_components.code,{children:`message_id`}),`, `,_jsx(_components.code,{children:`status`}),`, `,_jsx(_components.code,{children:`delivery`}),`,\n`,_jsx(_components.code,{children:`location`}),`, and `,_jsx(_components.code,{children:`status_url`}),`. Read the returned `,_jsx(_components.code,{children:`status_url`}),`\n(`,_jsx(_components.code,{children:`GET /api/v1/locations/{message_id}`}),`) with the same authentication to inspect\nrecorded queued/acknowledged/sent/delivered evidence. Acceptance or acknowledgement\nis not recipient rendering. This status route applies to the enabled card path;\ndo not assume every older location response includes it.`]}),`\n`,_jsxs(_components.p,{children:[`Preserve the same key and original request. A changed key creates another send.\nAfter an uncertain result or `,_jsx(_components.code,{children:`retryable: false`}),`, reconcile before sending again;\ndo not automatically downgrade a requested card to a URL.`]}),`\n`,_jsx(Heading,{level:`2`,id:`advanced-chat-routing-—-other-enabled-lines`,children:`Advanced chat routing — other enabled lines`}),`\n`,_jsxs(_components.p,{children:[`Use this section only when Chert confirms the line supports this legacy routing.\nLocation-card-enabled lines reject `,_jsx(_components.code,{children:`chat_id`}),`. Most callers should send by `,_jsx(_components.code,{children:`phone`}),`. `,_jsx(_components.code,{children:`chat_id`}),` is only for Chert-provided delivery chat ids; it is not the UUID returned by `,_jsx(_components.code,{children:`POST /api/v1/chats`}),`.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,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:`6`,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:` \"chat_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"iMessage;+;chat42\"`}),_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:` \"latitude\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`40.758896`}),_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:` \"longitude\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`-73.985130`}),_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:` \"label\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Times Square\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`response-—-existing-location-path`,children:`Response — existing location path`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`14`,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:`14`,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:` \"message_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"msg_01H...\"`}),_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:`\"queued\"`}),_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:` \"phone_line_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"pl_15555550100\"`}),_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:` \"delivery\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"queued\"`}),_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:` \"location\"`}),_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:` \"latitude\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`40.758896`}),_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:` \"longitude\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`-73.98513`}),_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:` \"label\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Times Square\"`}),_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:` \"address\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Manhattan, NY\"`}),_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:` \"mode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"balloon\"`}),_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:` \"fallback_mode_requested\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"auto\"`})]}),`\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`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`202`}),` means the location request was accepted by the sender line. The final recipient UI is device-dependent: supported iMessage clients may render a map card; fallback clients receive a tappable Apple Maps URL.`]}),`\n`,_jsx(Heading,{level:`2`,id:`fields`,children:`Fields`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Required`}),_jsx(_components.th,{children:`Notes`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`phone`})}),_jsxs(_components.td,{children:[`Yes, unless `,_jsx(_components.code,{children:`chat_id`}),` is set`]}),_jsxs(_components.td,{children:[`Recipient in E.164 format. Pass either `,_jsx(_components.code,{children:`phone`}),` or `,_jsx(_components.code,{children:`chat_id`}),`, not both.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`chat_id`})}),_jsxs(_components.td,{children:[`Yes, unless `,_jsx(_components.code,{children:`phone`}),` is set`]}),_jsxs(_components.td,{children:[`Chert-provided delivery chat id. This is not the public UUID returned by `,_jsx(_components.code,{children:`/api/v1/chats`}),`. Pass either `,_jsx(_components.code,{children:`chat_id`}),` or `,_jsx(_components.code,{children:`phone`}),`, not both.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`latitude`})}),_jsx(_components.td,{children:`Yes`}),_jsxs(_components.td,{children:[`Number from `,_jsx(_components.code,{children:`-90`}),` to `,_jsx(_components.code,{children:`90`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`longitude`})}),_jsx(_components.td,{children:`Yes`}),_jsxs(_components.td,{children:[`Number from `,_jsx(_components.code,{children:`-180`}),` to `,_jsx(_components.code,{children:`180`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`label`})}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Place name shown in the card or text fallback.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`address`})}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Secondary place text.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`url`})}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Unsupported on the native card path. Otherwise omit unless Chert confirms support.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`fallback_mode`})}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[`Native card path: `,_jsx(_components.code,{children:`auto`}),` selects a card without automatic URL fallback; `,_jsx(_components.code,{children:`balloon`}),` requests a card; `,_jsx(_components.code,{children:`geo_url`}),` explicitly requests URL text. `,_jsx(_components.code,{children:`vcard`}),` is unsupported.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`expires_at`})}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Stored and echoed for your own bookkeeping. It does not create an ongoing or expiring Live Location share on the recipient device.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`phone_line_id`})}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Use a specific assigned sender line. Most callers should omit this.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`idempotency_key`})}),_jsx(_components.td,{children:`Required for the native card path`}),_jsx(_components.td,{children:`Nonempty, up to 128 characters on that path. Preserve the same key and request; do not retry uncertain outcomes automatically.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`external_id`})}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Your application record id.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`common-errors`,children:`Common errors`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Code`}),_jsx(_components.th,{children:`When`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`1001`})}),_jsxs(_components.td,{children:[`Missing `,_jsx(_components.code,{children:`phone`}),`/`,_jsx(_components.code,{children:`chat_id`}),`, or missing coordinates.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`1002`})}),_jsxs(_components.td,{children:[`Both `,_jsx(_components.code,{children:`phone`}),` and `,_jsx(_components.code,{children:`chat_id`}),` were passed, or coordinates are out of range.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`3002`})}),_jsx(_components.td,{children:`No eligible sender line is available for location sharing.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`4001`})}),_jsx(_components.td,{children:`The sender line accepted the request but delivery failed downstream.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`4099`})}),_jsx(_components.td,{children:`Location sharing is not available on the selected sender line, or the requested mode is unsupported.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`see-also`,children:`See also`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/api/sending`,children:`Sending`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/api/chats/create`,children:`Create a chat`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/api/chats/send-message`,children:`Send a message`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/api/errors`,children:`Errors`})}),`\n`]})]})}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":"Send a location","description":"POST /api/v1/locations - send a one-time location pin.","icon":"map-pin","href":"/api/locations"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Request","slug":"request","depth":2,"children":[]},{"title":"Location-card-enabled lines","slug":"location-card-enabled-lines","depth":2,"children":[]},{"title":"Advanced chat routing — other enabled lines","slug":"advanced-chat-routing-—-other-enabled-lines","depth":2,"children":[]},{"title":"Response — existing location path","slug":"response-—-existing-location-path","depth":2,"children":[]},{"title":"Fields","slug":"fields","depth":2,"children":[]},{"title":"Common errors","slug":"common-errors","depth":2,"children":[]},{"title":"See also","slug":"see-also","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"cherttechnologiesinc","siteName":"Chert","title":"Send a location - Chert","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-11T14:45:49.520Z","originalFileLocation":"api/locations.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=\"light\"}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=\"POST /api/v1/locations - send a one-time location pin.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Chert\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cherttechnologiesinc/I_UeOi_EkhPM1c_6/_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/cherttechnologiesinc/I_UeOi_EkhPM1c_6/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cherttechnologiesinc/I_UeOi_EkhPM1c_6/_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/cherttechnologiesinc/I_UeOi_EkhPM1c_6/_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/cherttechnologiesinc/I_UeOi_EkhPM1c_6/_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/cherttechnologiesinc/I_UeOi_EkhPM1c_6/_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/cherttechnologiesinc/I_UeOi_EkhPM1c_6/_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/cherttechnologiesinc/I_UeOi_EkhPM1c_6/_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/cherttechnologiesinc/I_UeOi_EkhPM1c_6/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Send a location - Chert\">\u003cmeta data-mint-head property=\"og:description\" content=\"POST /api/v1/locations - send a one-time location pin.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Chert\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.trychert.com/api/locations\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cherttechnologiesinc.mintlify.site/_mintlify/api/og/v2?division=Messages\u0026amp;title=Send+a+location\u0026amp;description=POST+%2Fapi%2Fv1%2Flocations+-+send+a+one-time+location+pin.\u0026amp;theme=9e94663447033a0c94d7962d\u0026amp;signature=88a85f7ad70fafa40f70bcd6a430df128ccc9db1c2a75c9e256fbfcfe88fafef\">\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=\"Send a location - Chert\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"POST /api/v1/locations - send a one-time location pin.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cherttechnologiesinc.mintlify.site/_mintlify/api/og/v2?division=Messages\u0026amp;title=Send+a+location\u0026amp;description=POST+%2Fapi%2Fv1%2Flocations+-+send+a+one-time+location+pin.\u0026amp;theme=9e94663447033a0c94d7962d\u0026amp;signature=88a85f7ad70fafa40f70bcd6a430df128ccc9db1c2a75c9e256fbfcfe88fafef\">\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/cherttechnologiesinc/I_UeOi_EkhPM1c_6/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Chert\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#E84A10\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.trychert.com/api/locations\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api/locations.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.trychert.com/#organization\",\"name\":\"Chert\",\"url\":\"https://docs.trychert.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cherttechnologiesinc/jd3nvtW3TQewqkHo/logo/light.png?fit=max\u0026auto=format\u0026n=jd3nvtW3TQewqkHo\u0026q=85\u0026s=137a61b59b0a21d5afc0e14ca6e5c8f6\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.trychert.com#website\",\"name\":\"Chert\",\"url\":\"https://docs.trychert.com\",\"publisher\":{\"@id\":\"https://docs.trychert.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.trychert.com/api/locations#webpage\",\"url\":\"https://docs.trychert.com/api/locations\",\"name\":\"Send a location\",\"description\":\"POST /api/v1/locations - send a one-time location pin.\",\"dateModified\":\"2026-11-11T14:45:49.520Z\",\"isPartOf\":{\"@id\":\"https://docs.trychert.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.trychert.com/api/locations#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.trychert.com/api/locations#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Messages\",\"item\":\"https://docs.trychert.com/api/sending\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Send a location\",\"item\":\"https://docs.trychert.com/api/locations\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.trychert.com/api/locations#article\",\"headline\":\"Send a location\",\"name\":\"Send a location\",\"description\":\"POST /api/v1/locations - send a one-time location pin.\",\"url\":\"https://docs.trychert.com/api/locations\",\"mainEntityOfPage\":{\"@id\":\"https://docs.trychert.com/api/locations#webpage\"},\"dateModified\":\"2026-11-11T14:45:49.520Z\",\"publisher\":{\"@id\":\"https://docs.trychert.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.trychert.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Chert\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Chert\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api/locations.md","siteName":"Chert","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"Integrations","icon":"puzzle-piece","pages":[{"title":"Integrations","href":"/salesforce/overview"}]},{"tab":"Messaging API","icon":"code","groups":[{"group":"Get started","pages":[{"title":"Overview","icon":"code","href":"/api/overview"},{"title":"Quickstart","icon":"bolt","href":"/api/quickstart"},{"title":"Usage examples","icon":"terminal","href":"/api/usage-examples"},{"title":"Authentication","icon":"key","href":"/api/authentication"}]},{"group":"Messages","pages":[{"title":"Sending","icon":"paper-plane","href":"/api/sending"},{"title":"Text formatting","href":"/api/text-formatting"},{"title":"Voice notes","description":"Stage audio and send it as a native iMessage voice note.","icon":"waveform","href":"/api/voice-notes"},{"title":"Send a location","icon":"map-pin","href":"/api/locations"},{"title":"Polls","description":"Send a poll and read its votes.","href":"/api/polls"},{"title":"React to a message","icon":"heart","href":"/api/messages/react"},{"title":"Edit a message","icon":"pen-to-square","href":"/api/messages/edit"},{"title":"Attachments","icon":"paperclip","href":"/api/attachments"}]},{"group":"Chats","pages":[{"title":"Create a chat","icon":"plus","href":"/api/chats/create"},{"title":"Send a message","icon":"paper-plane","href":"/api/chats/send-message"},{"title":"List messages","icon":"list","href":"/api/chats/list-messages"},{"title":"Typing indicators","icon":"keyboard","href":"/api/chats/typing"},{"title":"Mark a chat as read","icon":"envelope-open","href":"/api/chats/mark-read"}]},{"group":"Group chats","pages":[{"title":"Create a group","icon":"users","href":"/api/group-chats/create"},{"title":"Rename a group","icon":"pen-to-square","href":"/api/group-chats/rename"},{"title":"Add a participant","icon":"user-plus","href":"/api/group-chats/add-participant"},{"title":"Remove a participant","icon":"user-minus","href":"/api/group-chats/remove-participant"},{"title":"Leave a group","icon":"right-from-bracket","href":"/api/group-chats/leave"}]},{"group":"Contact sharing","pages":[{"title":"Share line's contact info","icon":"id-badge","href":"/api/contact-sharing/share-info"},{"title":"Send a contact card","icon":"address-book","href":"/api/contact-sharing/send-card"}]},{"group":"Webhooks and events","pages":[{"title":"Phone numbers","icon":"phone","href":"/api/phone-numbers"},{"title":"Webhook subscriptions","icon":"webhook","href":"/api/webhook-subscriptions"},{"title":"Receiving replies","icon":"inbox","href":"/api/receiving-replies"},{"title":"Events","icon":"wave-pulse","href":"/api/events"}]},{"group":"Reference","pages":[{"title":"Errors","icon":"triangle-exclamation","href":"/api/errors"}]}]},{"tab":"FaceTime","icon":"video","pages":[{"title":"FaceTime","href":"/facetime/introduction"}]}]},"basePath":"","title":"Send a location - Chert","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":[],"chunks":[]}