Developer API

Programmatic control over your workflows

Integrate Roxi into your custom internal dashboards, CRM portals, or proprietary software platforms. Connect contacts, emit pipeline event webhooks, and automate multi-channel messaging.

Authentication

All REST API requests must be authenticated using Bearer tokens sent in the Authorization header:

Authorization: Bearer rx_live_8f3d9c...

Endpoints Overview

POST/v1/contacts

Creates or updates a contact profile. Can trigger custom welcome workflow sequences automatically.

POST/v1/workflows/trigger

Triggers a specific automation workflow manually for a designated contact ID.

GET/v1/conversations

Fetches recent message threads from Facebook, Instagram, SMS, and Email inboxes.

curl -X POST https://api.roxi.ca/v1/contacts \
  -H "Authorization: Bearer rx_live_8f3d9c..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Alex Carter",
    "email": "alex@company.com",
    "phone": "+15551234567",
    "company": "Carter Logistics",
    "customFields": {
      "lead_value": "4500"
    }
  }'