All Docs

Quickstart

Create an API key and publish your first post in under 5 minutes

Prerequisites

  • An EziBreezy account with at least one workspace
  • A connected social account (e.g., X/Twitter, Instagram) in that workspace
  • Admin role on the organization

Step 1: Create an API key

Go to Settings > API Keys in your workspace dashboard at app.ezibreezy.com and click Create Key.

Give it a name (e.g., "My first API key") and choose an expiration period. Click Create Key — the raw key is shown once. Copy it immediately and store it securely.

Important: The full API key is only displayed at creation time. You won't be able to see it again — only the prefix is shown in the dashboard.

Step 2: Find your workspace and integration

Use your API key to discover your workspaces:

curl https://api.ezibreezy.com/v1/workspaces \
  -H "Authorization: Bearer ezb_live_abc123..."
{
  "data": [
    {
      "id": "ws-uuid",
      "name": "Main Workspace",
      "slug": "main-workspace",
      "organizationId": "org-uuid",
      "role": "admin"
    }
  ],
  "meta": null
}

Then list connected accounts for that workspace:

curl https://api.ezibreezy.com/v1/integrations \
  -H "Authorization: Bearer ezb_live_abc123..." \
  -H "x-workspace-id: YOUR_WORKSPACE_ID"
{
  "data": [
    {
      "id": "integration-uuid",
      "platform": "x",
      "username": "your_handle",
      "name": "Your Account Name",
      "status": "connected"
    }
  ],
  "meta": null
}

Save the id from the integration you want to post to.

Step 3: Create a post

Schedule a post for the future:

curl -X POST https://api.ezibreezy.com/v1/posts \
  -H "Authorization: Bearer ezb_live_abc123..." \
  -H "x-workspace-id: YOUR_WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "integrationId": "YOUR_INTEGRATION_ID",
    "content": "Hello from the EziBreezy API!",
    "scheduledAt": "2027-01-01T12:00:00Z"
  }'
{
  "data": {
    "id": "post-uuid",
    "status": "scheduled"
  },
  "meta": null
}

Or publish immediately by omitting scheduledAt:

curl -X POST https://api.ezibreezy.com/v1/posts \
  -H "Authorization: Bearer ezb_live_abc123..." \
  -H "x-workspace-id: YOUR_WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "integrationId": "YOUR_INTEGRATION_ID",
    "content": "Published right now via the API!"
  }'

Step 4: Verify

Check your post was created:

curl https://api.ezibreezy.com/v1/posts \
  -H "Authorization: Bearer ezb_live_abc123..." \
  -H "x-workspace-id: YOUR_WORKSPACE_ID"

Next steps

PreviousIntroductionNextAuthentication