Skip to main content
POST
AhaSend Go SDK

Authorizations

Authorization
string
header
required

API key for authentication. Non-empty Security Requirement values are AhaSend API-key roles. Roles listed within one requirement object are jointly required; separate requirement objects are alternatives.

Headers

Idempotency-Key
string

Optional idempotency key for safe request retries. Must be a unique string for each logical request. An identical request with a completed stored outcome returns the original status and body. An in-progress execution returns 409, a changed method/path/body returns 422, and a released 5xx execution may run again. Keys for non-secret responses expire after 24 hours. API-key create responses include a one-time secret_key, so successful encrypted replay responses for those operations expire after 5 minutes.

Maximum string length: 255

Path Parameters

account_id
string<uuid>
required

Account ID

Body

application/json
name
string
required

Route name

Maximum string length: 255
url
string<uri>
required

Webhook URL for the route

recipient
string
required

Recipient filter

Maximum string length: 255
attachments
boolean
default:false

Whether to include attachments in webhooks

headers
boolean
default:false

Whether to include headers in webhooks

group_by_message_id
boolean
default:false

Whether to group by message ID

strip_replies
boolean
default:false

Whether to strip reply content

enabled
boolean
default:true

Whether the route is enabled

Response

Route created successfully

object
enum<string>
required

Object type identifier

Available options:
route
id
string<uuid>
required

Unique identifier for the route

created_at
string<date-time>
required

When the route was created

updated_at
string<date-time>
required

When the route was last updated

name
string
required

Route name

url
string<uri>
required

Webhook URL for the route

recipient
string
required

Recipient filter; an empty string means no recipient filter

attachments
boolean
required

Whether to include attachments in route payload

headers
boolean
required

Whether to include headers in route payload

group_by_message_id
boolean
required

Whether to group by message ID

strip_replies
boolean
required

Whether to strip reply content

enabled
boolean
required

Whether the route is enabled

success_count
integer
required

Number of successful calls

error_count
integer
required

Number of unsuccessful calls

errors_since_last_success
integer
required

Number of consecutive failed calls

last_request_at
string<date-time> | null
required

When the route was last called

secret
string
required

Route signing secret. Returned only when the route is created.