Skip to main content

​
1. Open Your Tenant Workspace

Sign in to your tenant dashboard. Your tenant URL looks like: 
https://{tenant}.sinjapp.org
Use the exact tenant URL shown in the dashboard for all API calls. If the subdomain is mistyped, the API returns 404 Tenant could not be identified for this domain.

​
2. Manage Subscription And Payment

Choose or review your plan from inside the tenant dashboard. Payment and subscription management happen there.

​
3. Create An API Key

From the tenant dashboard: 
Access > API Keys > New API key
Copy the full key and use it in the X-Api-Key header: 
X-Api-Key: {tenant_api_key}

​
4. Download The Postman Collection

Use the collection if you want to test requests directly in Postman.

Download Postman Collection

Import the collection, then fill tenant_base_url and tenant_api_key.

​
5. Add A Sender Number

From the tenant dashboard: 
Messaging > Sender Numbers > New sender number
The sender number owner receives an OTP inside Sinjapp.

​
6. Verify The Sender Number

After the OTP is accepted, the sender number is confirmed as owned by the tenant. If the Sinjapp account is not verified yet, the sender number may stay in: 
pending_account_verification
The owner must complete Sinjapp account verification before customer messaging can start.

​
7. Send A Message

Use messages.send scope for this request. 
curl -X POST "https://{tenant}.sinjapp.org/api/v1/messages" \
  -H "X-Api-Key: {tenant_api_key}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "sender_phone": "{sender_phone}",
    "to_phone": "{recipient_phone}",
    "type": "text",
    "content": "Hello from Sinjapp Business"
  }'