Developers

REST API reference

Base URL: https://api.onepush.app/v1. Authenticate with a Bearer token. All responses are JSON.

Authentication

Include your API key in the Authorization header as a Bearer token. Keys are created in the OnePush dashboard under Settings → API Keys.

Authorization: Bearer op_live_xxxxxxxxxxxx

POST /v1/emails

Send a transactional email to one or more recipients.

{
  "to": "user@example.com",
  "from": "noreply@yourdomain.com",
  "subject": "Order confirmed",
  "html": "<h1>Thanks for your order</h1>",
  "text": "Thanks for your order"
}

POST /v1/social/posts

Publish or schedule a post to a connected social account.

{
  "account_id": "acc_xxxx",
  "text": "We just shipped a new feature!",
  "scheduled_at": "2026-06-15T09:00:00Z"
}

POST /v1/forms/{id}/submissions

Submit data to a form programmatically or retrieve submissions via GET.

{
  "fields": {
    "email": "lead@example.com",
    "name": "Jane Doe"
  }
}

Webhooks

Subscribe to events including email.delivered, email.bounced, social.published, and form.submitted. Payloads are signed with HMAC SHA256 for verification.