Skip to main content
A sender number is the Sinjapp account that appears as the sender for customer messages.

​
Statuses

StatusMeaning
pending_verificationThe number was created and is waiting for OTP confirmation
activeThe number is confirmed and can be used if the account is verified
pending_account_verificationOTP is correct, but the Sinjapp account still needs account verification
rejectedThe number cannot be used for sending

​
Create A Sender Number

Requires messages.send scope. 
curl -X POST "https://{tenant}.sinjapp.org/api/v1/sender-numbers" \
  -H "X-Api-Key: {tenant_api_key}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "{sender_phone}",
    "display_name": "Support line"
  }'
After creation, the sender number owner receives an OTP inside Sinjapp. The tenant customer enters the OTP in the tenant dashboard.

​
List Sender Numbers

curl "https://{tenant}.sinjapp.org/api/v1/sender-numbers" \
  -H "X-Api-Key: {tenant_api_key}" \
  -H "Accept: application/json"