Skip to content
SMS Reasons

POSThttps://core-api.heysadie.ai/sms-reasons

name reason message assistantId content properties success data id createdAt updatedAt metadata timestamp version path error code details field

Create sms reason

Create a new SMS reason for a specific assistant. SMS reasons define when the assistant should send an SMS to the caller and what it should say. Use this when: - A caller asks for something like a price list, link, or directions - You want to define what the assistant says and what content is sent via SMS ### Fields - `name`: A friendly label for internal use. Example: "Car Rental Price List" - `reason`: The trigger that causes the assistant to send an SMS. Example: "When the caller asks for available cars and wants to see pricing." - `message`: What the assistant says before sending the SMS. Example: "Sure, I'll send you a price list via SMS right now." - `assistantId`: The assistant this SMS reason is attached to. - `content`: The actual SMS body that will be sent to the caller. Example: "Here's the price list for tomorrow: https://yourapp.com/prices" ⚠️ Note: The `properties` field is used internally and doesn't need to be filled manually. This lets you define flexible and reusable ways to respond to common user requests with SMS follow-ups.

Try it in the API Explorer

Example request

Terminal
curl -X POST "https://core-api.heysadie.ai/sms-reasons" \
  -H "Authorization: ApiKey YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "reason": "string",
    "message": "string"
  }'

Authentication

Authenticate with an API key in the Authorization header using the ApiKey scheme — see Authentication for how keys work and where to get them.

Authorizationstringrequired

API key in the ApiKey scheme: ApiKey YOUR_API_KEY. Tenant keys authorize their own tenant; organization keys can act on any tenant in the organization.

X-Tenant-Idstring (uuid)optional

Required when authenticating with an organization key — selects the tenant the request acts on. Omit with tenant keys.

Request

Body application/json · required

namestringoptional

A friendly label for this SMS reason

reasonstringoptional

The event or trigger that causes this SMS to be sent (e.g., user asks for a price list)

messagestringoptional

What the assistant says before sending the SMS (e.g., 'I'll send you the price list via SMS')

assistantIdstring (uuid)optional

The assistant ID this reason is associated with

contentstringoptional

The actual SMS message to be sent to the caller (e.g., a link or info)

propertiesanyoptional

Responses

200
successbooleanrequired
dataobjectoptional
Show 9 child properties
idstringrequired
namestringrequired
reasonstringrequired
messagestringrequired
assistantIdstringrequired
propertiesanyrequired
contentstringrequired
createdAtstring (date-time) | string (date) | number | nullrequired
updatedAtstring (date-time) | string (date) | number | nullrequired
metadataobjectoptional
Show 3 child properties
timestampstringrequired
versionstringrequired
pathstringoptional
400
successbooleanrequired
errorobjectoptional
Show 3 child properties
codeenumrequired
Allowed values:"VALIDATION_ERROR"
messagestringrequired
detailsobject[]optional
Show 2 item properties
fieldstringrequired
messagestringrequired
metadataobjectoptional
Show 3 child properties
timestampstringrequired
versionstringrequired
pathstringoptional
401
successbooleanrequired
errorobjectoptional
Show 2 child properties
codeenumrequired
Allowed values:"UNAUTHORIZED"
messagestringrequired
metadataobjectoptional
Show 3 child properties
timestampstringrequired
versionstringrequired
pathstringoptional
403
successbooleanrequired
errorobjectoptional
Show 2 child properties
codeenumrequired
Allowed values:"FORBIDDEN"
messagestringrequired
metadataobjectoptional
Show 3 child properties
timestampstringrequired
versionstringrequired
pathstringoptional
404
successbooleanrequired
errorobjectoptional
Show 2 child properties
codeenumrequired
Allowed values:"RESOURCE_NOT_FOUND"
messagestringrequired
metadataobjectoptional
Show 3 child properties
timestampstringrequired
versionstringrequired
pathstringoptional
500
successbooleanrequired
errorobjectoptional
Show 2 child properties
codeenumrequired
Allowed values:"INTERNAL_SERVER_ERROR"
messagestringrequired
metadataobjectoptional
Show 3 child properties
timestampstringrequired
versionstringrequired
pathstringoptional