API reference

Pocket Isa REST API

Test endpoints, view schemas, and copy cURL commands. Responses are JSON.

Base URL

https://backend.rubyorbit.com/functions/v1

Authentication

Pass your API key in the x-api-key header. Authorization: Bearer also works. Generate keys from Settings → Integrations → REST API.

Endpoints

Method	Path	Summary
GET	`/api-test`	Test Connection
POST	`/api-leads-upsert`	Create or Update Lead
POST	`/api-timeline-add`	Add Timeline Event

GET /api-test

curl https://backend.rubyorbit.com/functions/v1/api-test \
  -H "x-api-key: YOUR_API_KEY"

POST /api-leads-upsert

Creates or updates a lead, matched by email.

curl -X POST https://backend.rubyorbit.com/functions/v1/api-leads-upsert \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"first_name":"Jane","last_name":"Doe","email":"jane@example.com","phone":"+15551234567","source":"Website Form","category":"real_estate","tags":["webform","buyer"]}'

POST /api-timeline-add

Adds a call, sms, email, meeting, or note to a lead's timeline.

curl -X POST https://backend.rubyorbit.com/functions/v1/api-timeline-add \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"email":"jane@example.com","event_type":"call","event_title":"Discovery call","event_body":"Discussed budget. Wants to see listings this week.","source":"dialer"}'

For full field documentation including category-specific context fields, see Data mapping.