Tenant API Code Examples in cURL, JS, PHP, Python - Sinjapp Business

Use these examples as a starting point for your integration. Replace {tenant} with your tenant subdomain and keep API keys on the server side.

Send A Text Message

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"
  }'

const response = await fetch('https://{tenant}.sinjapp.org/api/v1/messages', {
  method: 'POST',
  headers: {
    'X-Api-Key': tenantApiKey,
    'Accept': 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    sender_phone: senderPhone,
    to_phone: recipientPhone,
    type: 'text',
    content: 'Hello from Sinjapp Business',
  }),
})

const message = await response.json()

<?php

$response = file_get_contents('https://{tenant}.sinjapp.org/api/v1/messages', false, stream_context_create([
    'http' => [
        'method' => 'POST',
        'header' => [
            'X-Api-Key: ' . $tenantApiKey,
            'Accept: application/json',
            'Content-Type: application/json',
        ],
        'content' => json_encode([
            'sender_phone' => $senderPhone,
            'to_phone' => $recipientPhone,
            'type' => 'text',
            'content' => 'Hello from Sinjapp Business',
        ]),
        'timeout' => 30,
    ],
]));

$message = json_decode($response, true);

import requests

response = requests.post(
    "https://{tenant}.sinjapp.org/api/v1/messages",
    headers={
        "X-Api-Key": tenant_api_key,
        "Accept": "application/json",
        "Content-Type": "application/json",
    },
    json={
        "sender_phone": sender_phone,
        "to_phone": recipient_phone,
        "type": "text",
        "content": "Hello from Sinjapp Business",
    },
    timeout=30,
)

message = response.json()

Send An Audio Attachment With A Caption

Use audio for a file uploaded by your integration. The content field is its optional caption, and duration may be omitted.

curl -X POST "https://{tenant}.sinjapp.org/api/v1/messages" \
  -H "X-Api-Key: {tenant_api_key}" \
  -H "Accept: application/json" \
  -F "sender_phone={sender_phone}" \
  -F "to_phone={recipient_phone}" \
  -F "type=audio" \
  -F "content=Meeting summary" \
  -F "media=@/path/to/meeting.mp3"

const formData = new FormData()
formData.append('sender_phone', senderPhone)
formData.append('to_phone', recipientPhone)
formData.append('type', 'audio')
formData.append('content', 'Meeting summary')
formData.append('media', file)

const response = await fetch('https://{tenant}.sinjapp.org/api/v1/messages', {
  method: 'POST',
  headers: {
    'X-Api-Key': tenantApiKey,
    'Accept': 'application/json',
  },
  body: formData,
})

const message = await response.json()

<?php

$client = curl_init('https://{tenant}.sinjapp.org/api/v1/messages');

curl_setopt_array($client, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'X-Api-Key: ' . $tenantApiKey,
        'Accept: application/json',
    ],
    CURLOPT_POSTFIELDS => [
        'sender_phone' => $senderPhone,
        'to_phone' => $recipientPhone,
        'type' => 'audio',
        'content' => 'Meeting summary',
        'media' => new CURLFile('/path/to/meeting.mp3'),
    ],
]);

$message = json_decode(curl_exec($client), true);
curl_close($client);

import requests

with open("/path/to/meeting.mp3", "rb") as media:
    response = requests.post(
        "https://{tenant}.sinjapp.org/api/v1/messages",
        headers={
            "X-Api-Key": tenant_api_key,
            "Accept": "application/json",
        },
        data={
            "sender_phone": sender_phone,
            "to_phone": recipient_phone,
            "type": "audio",
            "content": "Meeting summary",
        },
        files={"media": ("meeting.mp3", media, "audio/mpeg")},
        timeout=30,
    )

message = response.json()

Use voice only for a recorded voice note and include duration from 1 to 300 seconds. Omit content for new voice-note integrations.

Check Contact Reachability

curl "https://{tenant}.sinjapp.org/api/v1/contacts/lookup?phone={recipient_phone}&sender_phone={sender_phone}" \
  -H "X-Api-Key: {tenant_api_key}" \
  -H "Accept: application/json"

const params = new URLSearchParams({
  phone: recipientPhone,
  sender_phone: senderPhone,
})

const response = await fetch(`https://{tenant}.sinjapp.org/api/v1/contacts/lookup?${params}`, {
  headers: {
    'X-Api-Key': tenantApiKey,
    'Accept': 'application/json',
  },
})

const lookup = await response.json()

<?php

$query = http_build_query([
    'phone' => $recipientPhone,
    'sender_phone' => $senderPhone,
]);

$response = file_get_contents('https://{tenant}.sinjapp.org/api/v1/contacts/lookup?' . $query, false, stream_context_create([
    'http' => [
        'method' => 'GET',
        'header' => [
            'X-Api-Key: ' . $tenantApiKey,
            'Accept: application/json',
        ],
        'timeout' => 30,
    ],
]));

$lookup = json_decode($response, true);

import requests

response = requests.get(
    "https://{tenant}.sinjapp.org/api/v1/contacts/lookup",
    headers={
        "X-Api-Key": tenant_api_key,
        "Accept": "application/json",
    },
    params={
        "phone": recipient_phone,
        "sender_phone": sender_phone,
    },
    timeout=30,
)

lookup = response.json()