Skip to content
v3Latest
Feedback

Send your first message

Create a test key, send an SMS to your own phone and read the delivery status — in under five minutes.

On this page

Create a test key, send an SMS to your own phone and read the delivery status — in under five minutes. Follow the steps below — it takes just a few minutes.

Before you begin#

  • A Relay account and a test-mode API key
  • curl or one of the official SDKs

Steps#

  1. Create a test key#

    Dashboard → Developers → API keys → Create key. Test keys start with rk_test_.

  2. Send a message#

    Call POST /v3/messages with a channel, a recipient and a body.

  3. Check the status#

    The response includes an ID. Fetch GET /v3/messages/{id} or listen for webhooks.

Tip

Test mode never sends real messages or charges your account.

Example#

POST /v3/messages
curl https://api.relay.example/v3/messages \
  -H "Authorization: Bearer $RELAY_KEY" \
  -d channel=sms \
  -d to=+15550100001 \
  -d body="Your code is 482913"

Still stuck?#

Include the request ID from the Relay-Request-Id response header — it lets us find your call in seconds.

Was this article helpful?