Quickstart

Send your first MorisBox message in under five minutes.

1. Get an API key

MorisBox sandbox access is granted per partner. Once your organization is enabled:

Sign in to Partner Hub → https://partner.morisbox.com
Open Settings → API Keys
Create a key with the send scope (or full for broader integration work)
Copy the secret once - it is displayed only when created

Never commit API keys. Prefer environment variables, and never share keys between organizations.

2. Base URL

Sandbox (partner integrations):

https://api.morisbox.com/api/v1

3. Send a text message

Replace $SEED360_API_KEY with the key from Partner Hub.

export SEED360_API_BASE="https://api.morisbox.com/api/v1"
export SEED360_API_KEY="sk_…"   # partner key

curl -X POST "$SEED360_API_BASE/messages" \
  -H "Authorization: Bearer $SEED360_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+228XXXXXXXX",
    "body": "Bienvenue sur MorisBox",
    "priority": "notification"
  }'

Use a real E.164 end-user phone number that is linked - or will be linked - to your partner organization.

Success response

{
  "message_id": 123,
  "ref": "a1b2c3…",
  "phone": "+228XXXXXXXX",
  "content_type": "text",
  "body": "Bienvenue sur MorisBox",
  "state": "delivered"
}

The message appears under your partner in the user's Client Application (hub / inbox). It does not become a support conversation unless you use the Conversations API.

4. Send an image

curl -X POST "$SEED360_API_BASE/messages" \
  -H "Authorization: Bearer $SEED360_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+228XXXXXXXX",
    "content_type": "image",
    "body": "Photo de l’agence",
    "media_url": "https://example.com/photo.jpg",
    "media_filename": "agence.jpg"
  }'

5. Send an HTML newsletter

curl -X POST "$SEED360_API_BASE/messages" \
  -H "Authorization: Bearer $SEED360_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+228XXXXXXXX",
    "content_type": "html",
    "subject": "Infos · Juillet",
    "html": "<h1>Bonjour</h1><p>Votre newsletter…</p>"
  }'

On mobile, the user opens the complete newsletter directly from the hub list.

6. Next

Topic	Link
Authentication and scopes	Authentication
All content types	Media and Content Types
Interactive forms	Flows
Sandbox hosts	Sandbox and Live
Not a partner?	Developer Accounts (approved templates only)
Error format	Errors