Inbound email

SendSignal can receive mail addressed to your verified domain, parse it, and hand it to you as structured data: for support inboxes, reply handling, or automations.

Enable receiving

curl https://api.sendsignal.dev/domains/{id}/receiving \
  -H "Authorization: Bearer ss_..." -H "Content-Type: application/json" \
  -d '{"enabled": true}'

SendSignal provisions the MX record for inbound mail; publish it like the other domain records. Send {"enabled": false} to turn receiving off again.

Reading inbound mail

Received messages are parsed into headers, HTML and text bodies, and attachments:

• GET /emails/received: list inbound messages (id, from, to, subject, html, text, created_at).
• GET /emails/received/{id}: one message.
• GET /emails/received/{id}/attachments: attachment metadata (filename, content type, size).
• GET /emails/received/{id}/attachments/{attachmentId}: download an attachment.

Each arrival also fires an email.received webhook event and the email.received automation trigger, so you can react in real time instead of polling.

Note: sending_access API keys cannot read inbound mail; use a full_access key.