First call,
five minutes.
Generate a key, list conversations, send a reply, register a webhook. No SDK install required. SDKs are sugar.
01
Create an API key
Open Settings → API Keys, click New key, give it a label, pick scopes. Copy once. Keys starting with ir_live_ deliver real messages. Keys starting with ir_test_ never do.
# .env
IR_API_KEY=ir_live_3f2a...02
List your conversations
Every list endpoint is cursor-paginated. Pass ?cursor= for the next page. Max 100 per call.
curl https://instantreply.up.railway.app/v1/conversations \
-H "Authorization: Bearer $IR_API_KEY"03
Send a reply
POST a message to a conversation. With a test key the call returns a fake 201 and never touches Meta. With a live key the platform handles delivery, retries, and platform compliance.
curl -X POST https://instantreply.up.railway.app/v1/conversations/$ID/messages \
-H "Authorization: Bearer $IR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "content": "Thanks for reaching out." }'04
Register a webhook
The response includes a signing secret (whsec_...). Verify the X-IR-Signature header on every incoming payload. Failed deliveries retry on an exponential backoff for 30 days.
curl -X POST https://instantreply.up.railway.app/v1/webhooks \
-H "Authorization: Bearer $IR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://yourapp.com/webhooks/ir",
"events": ["message.received", "conversation.closed"]
}'Next