Send text as JSON, or send one image, document, uploaded audio file, or recorded voice note as multipart form data. Use audio for uploaded audio and reserve voice for recorded voice notes.
POST
/
messages
Error
A valid request URL is required to generate request examples
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Sinjapp Business","description":"Tenant API documentation for Sinjapp Business text, image, document, audio, voice-note, sender-number, contact, usage, and MCP workflows.","colors":{"primary":"#f59e0b","light":"#f59e0b","dark":"#fbbf24"},"favicon":"https://sinjapp.com/favicon.png","navbar":{"links":[{"href":"https://business.sinjapp.com","label":"Sinjapp Business"},{"href":"/scalar","label":"Scalar"},{"href":"/postman-collection","label":"Postman"},{"href":"/mcp","label":"MCP"}]},"footer":{"socials":{}},"contextual":{"options":["copy","mcp","add-mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"tgo","hasAudioNarration":false,"actualSubdomain":"tgo","customDomains":["docs.sinjapp.org"],"gitSource":{"type":"github","owner":"hosamalzagh","repo":"sinjappbusinessdocs","deployBranch":"master","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aa6e1da305bc58a07fe18c1","collectionId":"a097450a-4ec7-4e2f-b6af-43647aeba9cf","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aa6e1da305bc58a07fe18c1"},"feedback":{"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aa6e1da305bc58a07fe18c1","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"default","tag":"API Reference","count":11},{"language":"default","tag":"Messaging setup","count":6},{"language":"default","tag":"Start","count":4},{"language":"default","tag":"Messages","count":3},{"language":"default","tag":"API Keys","count":2},{"language":"default","tag":"Sender Numbers","count":2},{"language":"default","tag":"Examples","count":1},{"language":"default","tag":"AI tools","count":1},{"language":"default","tag":"Interactive reference","count":1},{"language":"default","tag":"Auth","count":1}]},"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":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","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":"editor-private-page-search","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":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/messages/send-a-message","slug":"/api-reference/messages/send-a-message","pageMetadata":{"title":"Send a message","description":"Send text as JSON, or send one image, document, uploaded audio file, or recorded voice note as multipart form data. Use audio for uploaded audio and reserve voice for recorded voice notes.","deprecated":null,"version":null,"openapi":"/openapi/sinjapp-business.v1.yaml post /messages","href":"/api-reference/messages/send-a-message","autogeneratedByOpenApi":true},"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: \"Send text as JSON, or send one image, document, uploaded audio file, or recorded voice note as multipart form data. Use audio for uploaded audio and reserve voice for recorded voice notes.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Send a message","description":"Send text as JSON, or send one image, document, uploaded audio file, or recorded voice note as multipart form data. Use audio for uploaded audio and reserve voice for recorded voice notes.","deprecated":null,"version":null,"openapi":"/openapi/sinjapp-business.v1.yaml post /messages","href":"/api-reference/messages/send-a-message","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Messages"],"summary":"Send a message","description":"Send text as JSON, or send one image, document, uploaded audio file, or recorded voice note as multipart form data. Use audio for uploaded audio and reserve voice for recorded voice notes.","operationId":"sendMessage","x-mint":{"mcp":{"enabled":false}},"security":["61ca02ca-3bdf-498b-aa90-40c6a84d35cb"],"requestBody":"8fd2d03b-6e8a-4de5-86f5-b2f9dcd3bd4f","responses":{"201":"54b47068-ae45-4fc0-a0c6-b21a28001550","422":"9c569948-122e-4c96-9ece-830e378959fc"},"method":"post","type":"path","servers":["9656af64-a735-4129-982e-85058a094ab6"],"path":"/messages","baseUrlOptions":["{tenantBaseUrl}/api/v1"],"title":"Send a message","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["to_phone","type"],"properties":{"to_phone":{"type":"string","example":"{recipient_phone}","isRequired":true,"uniqueKey":"to_phone","typeLabel":"string"},"type":{"type":"string","enum":["text","image","voice","audio","document"],"description":"Use audio for uploaded audio files and voice for recorded voice notes.","isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"sender_number_id":{"type":"integer","description":"Required when sender_phone is not provided.","uniqueKey":"sender_number_id","typeLabel":"integer"},"sender_phone":{"type":"string","description":"Required when sender_number_id is not provided.","example":"{sender_phone}","uniqueKey":"sender_phone","typeLabel":"string"},"content":{"oneOf":[{"type":"string","description":"Message body for text; optional caption for image, document, and audio. Legacy voice captions are accepted for compatibility.","uniqueKey":"content.oneOf.0","typeLabel":"string"},{"type":"null","description":"Message body for text; optional caption for image, document, and audio. Legacy voice captions are accepted for compatibility.","uniqueKey":"content.oneOf.1","typeLabel":"null"}],"uniqueKey":"content","typeLabel":"string | null"},"duration":{"oneOf":[{"type":"integer","minimum":1,"description":"Required for voice and limited to 1–300 seconds. Optional for audio with a minimum of 1 and no 300-second limit. Omit for other types.","uniqueKey":"duration.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":1,"description":"Required for voice and limited to 1–300 seconds. Optional for audio with a minimum of 1 and no 300-second limit. Omit for other types.","uniqueKey":"duration.oneOf.1","typeLabel":"null"}],"uniqueKey":"duration","typeLabel":"integer | null"},"file_name":{"oneOf":[{"type":"string","uniqueKey":"file_name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"file_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"file_name","typeLabel":"string | null"},"file_size":{"oneOf":[{"type":"integer","uniqueKey":"file_size.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"file_size.oneOf.1","typeLabel":"null"}],"uniqueKey":"file_size","typeLabel":"integer | null"},"file_type":{"oneOf":[{"type":"string","uniqueKey":"file_type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"file_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"file_type","typeLabel":"string | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"to_phone":"{recipient_phone}","sender_number_id":123,"sender_phone":"{sender_phone}","content":"\u003cstring>","duration":2,"file_name":"\u003cstring>","file_size":123,"file_type":"\u003cstring>"}}},"exampleType":"generated"},"multipart/form-data":{"schema":{"type":"object","required":["to_phone","type"],"properties":{"to_phone":{"type":"string","example":"{recipient_phone}","isRequired":true,"uniqueKey":"to_phone","typeLabel":"string"},"type":{"type":"string","enum":["text","image","voice","audio","document"],"description":"Use audio for uploaded audio files and voice for recorded voice notes.","isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"sender_number_id":{"type":"integer","description":"Required when sender_phone is not provided.","uniqueKey":"sender_number_id","typeLabel":"integer"},"sender_phone":{"type":"string","description":"Required when sender_number_id is not provided.","example":"{sender_phone}","uniqueKey":"sender_phone","typeLabel":"string"},"content":{"oneOf":[{"type":"string","description":"Message body for text; optional caption for image, document, and audio. Legacy voice captions are accepted for compatibility.","uniqueKey":"content.oneOf.0","typeLabel":"string"},{"type":"null","description":"Message body for text; optional caption for image, document, and audio. Legacy voice captions are accepted for compatibility.","uniqueKey":"content.oneOf.1","typeLabel":"null"}],"uniqueKey":"content","typeLabel":"string | null"},"duration":{"oneOf":[{"type":"integer","minimum":1,"description":"Required for voice and limited to 1–300 seconds. Optional for audio with a minimum of 1 and no 300-second limit. Omit for other types.","uniqueKey":"duration.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":1,"description":"Required for voice and limited to 1–300 seconds. Optional for audio with a minimum of 1 and no 300-second limit. Omit for other types.","uniqueKey":"duration.oneOf.1","typeLabel":"null"}],"uniqueKey":"duration","typeLabel":"integer | null"},"file_name":{"oneOf":[{"type":"string","uniqueKey":"file_name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"file_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"file_name","typeLabel":"string | null"},"file_size":{"oneOf":[{"type":"integer","uniqueKey":"file_size.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"file_size.oneOf.1","typeLabel":"null"}],"uniqueKey":"file_size","typeLabel":"integer | null"},"file_type":{"oneOf":[{"type":"string","uniqueKey":"file_type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"file_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"file_type","typeLabel":"string | null"},"media":{"type":"string","format":"binary","description":"Required for image, document, audio, and voice messages. Send one file per request.","uniqueKey":"media","typeLabel":"file"}},"uniqueKey":"","typeLabel":"object"},"examples":{"audioWithCaption":{"title":"audioWithCaption","value":{"sender_phone":"{sender_phone}","to_phone":"{recipient_phone}","type":"audio","content":"Meeting summary","media":"meeting.mp3"}},"recordedVoiceNote":{"title":"recordedVoiceNote","value":{"sender_phone":"{sender_phone}","to_phone":"{recipient_phone}","type":"voice","duration":19,"media":"voice-note.m4a"}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"54b47068-ae45-4fc0-a0c6-b21a28001550":{"description":"Message accepted and logged.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"integer","description":"Tenant message log ID. Use this value in GET /messages/{messageLog}.","uniqueKey":"data.id","typeLabel":"integer"},"sender_number_id":{"type":"integer","uniqueKey":"data.sender_number_id","typeLabel":"integer"},"recipient_user_id":{"oneOf":[{"type":"integer","uniqueKey":"data.recipient_user_id.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"data.recipient_user_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.recipient_user_id","typeLabel":"integer | null"},"conversation_id":{"oneOf":[{"type":"integer","uniqueKey":"data.conversation_id.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"data.conversation_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.conversation_id","typeLabel":"integer | null"},"message_id":{"oneOf":[{"type":"integer","description":"Underlying Sinjapp chat message ID. This is not the ID accepted by GET /messages/{messageLog}.","uniqueKey":"data.message_id.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Underlying Sinjapp chat message ID. This is not the ID accepted by GET /messages/{messageLog}.","uniqueKey":"data.message_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.message_id","typeLabel":"integer | null"},"message_type":{"type":"string","enum":["text","image","voice","audio","document"],"uniqueKey":"data.message_type","typeLabel":"enum\u003cstring>"},"content":{"oneOf":[{"type":"string","description":"Text body or media caption.","uniqueKey":"data.content.oneOf.0","typeLabel":"string"},{"type":"null","description":"Text body or media caption.","uniqueKey":"data.content.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.content","typeLabel":"string | null"},"status":{"type":"string","description":"Dispatch status recorded when sending. sent means accepted and stored by Sinjapp; use delivery_status for delivery and reading.","example":"sent","uniqueKey":"data.status","typeLabel":"string"},"delivery_status":{"type":"string","readOnly":true,"enum":["sent","delivered","read","unknown"],"description":"Current recorded receipt state. sent means stored without confirmed delivery; delivered means the recipient app received the message; read means the recipient read it and implies delivery; unknown means the underlying message is missing, does not match the log, or has an unrecognized state. The recipient app must report receipt before delivered or read can be confirmed. Returned on send, list, and single-message responses. Dedicated delivery/read timestamps are not available.","example":"read","uniqueKey":"data.delivery_status","typeLabel":"enum\u003cstring>"},"request_payload":{"type":"object","additionalProperties":true,"uniqueKey":"data.request_payload","typeLabel":"object"},"response_payload":{"type":"object","properties":{"conversation_id":{"type":"integer","uniqueKey":"data.response_payload.conversation_id","typeLabel":"integer"},"message_id":{"type":"integer","uniqueKey":"data.response_payload.message_id","typeLabel":"integer"},"media_url":{"oneOf":[{"type":"string","format":"uri","description":"Managed media URL. Treat this value as opaque and do not construct a storage path.","uniqueKey":"data.response_payload.media_url.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","description":"Managed media URL. Treat this value as opaque and do not construct a storage path.","uniqueKey":"data.response_payload.media_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.response_payload.media_url","typeLabel":"string\u003curi> | null"}},"uniqueKey":"data.response_payload","typeLabel":"object"},"sent_at":{"oneOf":[{"type":"string","format":"date-time","description":"Dispatch acceptance time, not delivery or read time.","uniqueKey":"data.sent_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Dispatch acceptance time, not delivery or read time.","uniqueKey":"data.sent_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.sent_at","typeLabel":"string\u003cdate-time> | null"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"id":123,"sender_number_id":123,"recipient_user_id":123,"conversation_id":123,"message_id":123,"message_type":"text","content":"\u003cstring>","status":"sent","delivery_status":"read","request_payload":{},"response_payload":{"conversation_id":123,"message_id":123,"media_url":"\u003cstring>"},"sent_at":"2023-11-07T05:31:56Z"}}}},"exampleType":"generated"}},"exampleType":"generated"},"9c569948-122e-4c96-9ece-830e378959fc":{"description":"Validation failed.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"errors.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"errors.additionalProperties","typeLabel":"string[]"},"uniqueKey":"errors","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","errors":{}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"61ca02ca-3bdf-498b-aa90-40c6a84d35cb":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-Api-Key","scopes":["messages.send"]}}},"servers":{"9656af64-a735-4129-982e-85058a094ab6":{"url":"{tenantBaseUrl}/api/v1","description":"Tenant API","variables":{"tenantBaseUrl":{"default":"https://your-tenant.sinjapp.org","description":"Full customer tenant URL, including https://. Use the exact tenant workspace domain shown in the dashboard."}}}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-Api-Key","scopes":["messages.send"]},"schema":{"title":"X-Api-Key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"X-Api-Key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"openapi/sinjapp-business.v1.yaml"},"subdomain":"tgo","siteName":"Sinjapp Business","title":"Send a message - Sinjapp Business","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-13T17:48:22.566Z","originalFileLocation":"api-reference/messages/send-a-message.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Send text as JSON, or send one image, document, uploaded audio file, or recorded voice note as multipart form data. Use audio for uploaded audio and reserve voice for recorded voice notes.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Sinjapp Business\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://sinjapp.com/favicon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://sinjapp.com/favicon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://sinjapp.com/favicon.png\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/png\" href=\"https://sinjapp.com/favicon.png\">\u003cmeta data-mint-head property=\"og:title\" content=\"Send a message - Sinjapp Business\">\u003cmeta data-mint-head property=\"og:description\" content=\"Send text as JSON, or send one image, document, uploaded audio file, or recorded voice note as multipart form data. Use audio for uploaded audio and reserve voice for recorded voice notes.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Sinjapp Business\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.sinjapp.org/api-reference/messages/send-a-message\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://tgo.mintlify.app/_mintlify/api/og/v2?division=Messages\u0026amp;title=Send+a+message\u0026amp;description=Send+text+as+JSON%2C+or+send+one+image%2C+document%2C+uploaded+audio+file%2C+or+recorded+voice+note+as+multipart+form+data.+Use+audio+for+uploaded+audio+and+reserve+voi\u0026amp;theme=d81d6aa0a3647508d8f0fe2f\u0026amp;signature=6d2ca02899ddbe594d66001c4537b96fb653cffc527ca3e16b70640ee06a0df0\">\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 message - Sinjapp Business\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Send text as JSON, or send one image, document, uploaded audio file, or recorded voice note as multipart form data. Use audio for uploaded audio and reserve voice for recorded voice notes.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://tgo.mintlify.app/_mintlify/api/og/v2?division=Messages\u0026amp;title=Send+a+message\u0026amp;description=Send+text+as+JSON%2C+or+send+one+image%2C+document%2C+uploaded+audio+file%2C+or+recorded+voice+note+as+multipart+form+data.+Use+audio+for+uploaded+audio+and+reserve+voi\u0026amp;theme=d81d6aa0a3647508d8f0fe2f\u0026amp;signature=6d2ca02899ddbe594d66001c4537b96fb653cffc527ca3e16b70640ee06a0df0\">\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=\"https://mintlify.s3.us-west-1.amazonaws.com/tgo/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Sinjapp Business\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#f59e0b\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.sinjapp.org/api-reference/messages/send-a-message\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/messages/send-a-message.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.sinjapp.org/#organization\",\"name\":\"Sinjapp Business\",\"url\":\"https://docs.sinjapp.org\"},{\"@type\":\"WebSite\",\"@id\":\"https://docs.sinjapp.org#website\",\"name\":\"Sinjapp Business\",\"url\":\"https://docs.sinjapp.org\",\"publisher\":{\"@id\":\"https://docs.sinjapp.org/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.sinjapp.org/api-reference/messages/send-a-message#webpage\",\"url\":\"https://docs.sinjapp.org/api-reference/messages/send-a-message\",\"name\":\"Send a message\",\"description\":\"Send text as JSON, or send one image, document, uploaded audio file, or recorded voice note as multipart form data. Use audio for uploaded audio and reserve voice for recorded voice notes.\",\"dateModified\":\"2026-09-13T17:48:22.566Z\",\"isPartOf\":{\"@id\":\"https://docs.sinjapp.org#website\"},\"breadcrumb\":{\"@id\":\"https://docs.sinjapp.org/api-reference/messages/send-a-message#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.sinjapp.org/api-reference/messages/send-a-message#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.sinjapp.org/api-reference/auth/current-tenant-context\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Messages\",\"item\":\"https://docs.sinjapp.org/api-reference/messages/list-message-logs\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Send a message\",\"item\":\"https://docs.sinjapp.org/api-reference/messages/send-a-message\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.sinjapp.org/api-reference/messages/send-a-message#apireference\",\"headline\":\"Send a message\",\"name\":\"Send a message\",\"description\":\"Send text as JSON, or send one image, document, uploaded audio file, or recorded voice note as multipart form data. Use audio for uploaded audio and reserve voice for recorded voice notes.\",\"url\":\"https://docs.sinjapp.org/api-reference/messages/send-a-message\",\"mainEntityOfPage\":{\"@id\":\"https://docs.sinjapp.org/api-reference/messages/send-a-message#webpage\"},\"dateModified\":\"2026-09-13T17:48:22.566Z\",\"publisher\":{\"@id\":\"https://docs.sinjapp.org/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.sinjapp.org#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Sinjapp Business\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Sinjapp Business","nav":{"global":null,"groups":[{"group":"Start","pages":[{"title":"Sinjapp Business API","href":"/introduction"},{"title":"Quickstart: Send Your First Sinjapp Message","href":"/quickstart"},{"title":"Tenant API Key Authentication","href":"/authentication"},{"title":"Sinjapp Tenant API Postman Collection","href":"/postman-collection"}]},{"group":"Messaging setup","pages":[{"title":"Add and Verify Tenant Sender Numbers","href":"/sender-numbers"},{"title":"Sinjapp Account \u0026 Sender Number Verification","href":"/account-verification"},{"title":"Contacts Lookup by Phone Number","href":"/contacts-lookup"},{"title":"Send Messages and Track Delivery","href":"/messaging"},{"title":"Read Tenant Usage Counters and Limits","href":"/usage"},{"title":"Sinjapp Tenant API Errors and Fixes","href":"/errors"}]},{"group":"Examples","pages":[{"title":"Tenant API Code Examples in cURL, JS, PHP, Python","href":"/code-examples"}]},{"group":"AI tools","pages":[{"title":"MCP Server Setup for Sinjapp Docs","href":"/mcp-setup"}]},{"group":"Interactive reference","pages":[{"title":"Scalar Interactive API Reference","href":"/scalar"}]},{"group":"API Reference","pages":[{"group":"Auth","pages":[{"title":"Current tenant context","deprecated":null,"version":null,"openapi":"/openapi/sinjapp-business.v1.yaml get /me","href":"/api-reference/auth/current-tenant-context"}]},{"group":"Subscription","pages":[{"title":"Current tenant subscription","deprecated":null,"version":null,"openapi":"/openapi/sinjapp-business.v1.yaml get /subscription","href":"/api-reference/subscription/current-tenant-subscription"}]},{"group":"API Keys","pages":[{"title":"Create an API key","deprecated":null,"version":null,"openapi":"/openapi/sinjapp-business.v1.yaml post /api-keys","href":"/api-reference/api-keys/create-an-api-key"},{"title":"Revoke an API key","deprecated":null,"version":null,"openapi":"/openapi/sinjapp-business.v1.yaml delete /api-keys/{apiKey}","href":"/api-reference/api-keys/revoke-an-api-key"}]},{"group":"Sender Numbers","pages":[{"title":"List sender numbers","deprecated":null,"version":null,"openapi":"/openapi/sinjapp-business.v1.yaml get /sender-numbers","href":"/api-reference/sender-numbers/list-sender-numbers"},{"title":"Register a sender number","deprecated":null,"version":null,"openapi":"/openapi/sinjapp-business.v1.yaml post /sender-numbers","href":"/api-reference/sender-numbers/register-a-sender-number"}]},{"group":"Contacts","pages":[{"title":"Check whether a phone can receive messages","deprecated":null,"version":null,"openapi":"/openapi/sinjapp-business.v1.yaml get /contacts/lookup","href":"/api-reference/contacts/check-whether-a-phone-can-receive-messages"}]},{"group":"Messages","pages":[{"title":"List message logs","description":"Returns tenant logs with current delivery_status. The existing status and sent_at fields describe dispatch acceptance. Receipt states are read from Sinjapp on each request.","deprecated":null,"version":null,"openapi":"/openapi/sinjapp-business.v1.yaml get /messages","href":"/api-reference/messages/list-message-logs"},{"title":"Send a message","deprecated":null,"version":null,"openapi":"/openapi/sinjapp-business.v1.yaml post /messages","href":"/api-reference/messages/send-a-message"},{"title":"Read a message and its delivery status","description":"Read a message log belonging to the current tenant, including its current delivery_status. Use data.id from the send response, not the underlying chat message_id. Poll from your server with a delay and a timeout to track delivery or reading. Receipt timestamps and delivery webhooks are not exposed.","deprecated":null,"version":null,"openapi":"/openapi/sinjapp-business.v1.yaml get /messages/{messageLog}","href":"/api-reference/messages/read-a-message-and-its-delivery-status"}]},{"group":"Usage","pages":[{"title":"Read usage counters","deprecated":null,"version":null,"openapi":"/openapi/sinjapp-business.v1.yaml get /usage","href":"/api-reference/usage/read-usage-counters"}]}]}]},"title":"Send a message - Sinjapp Business","buildId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","deploymentId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-26-lDe7V.js","utils-CWQmgYtH.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-4-Aw3rSD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C2zjXYA5.js","snippetPresets-DFmpFA7C.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-FJpQavWq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D_GvPF7k.js","shallow-Bs2ZB0NO.js","getApiPlaygroundDisplay-DCcqJJk-.js","CodeSnippet-DzDxawVe.js","CodeSnippets-aUr7fU-7.js","Page-CT9uE8Ip.js","getPastedJson-Y1fKsj_I.js","icon-DI4zTsDr.js","MethodPill-C0nDlmSQ.js","DuplicateIcon-NUXbx2nQ.js","createIcon-BdTHrPAi.js","DynamicMarkdown-CtpgKJwj.js","SectionHeading-B3x35tOt.js","axios-vUo_bRtp.js","Markdown-3OmurJMP.js","clsx-DMKzROTp.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-1ms6tsT-.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Ke9xIMFx.js"]}