FlowCamp REST API

Returns the authenticated user's profile and current plan details.

Request

curl https://app.flowcamp.app/api/v1/me \
  -H "Authorization: Bearer fc_live_..."

Response

{
  "id":    "usr_abc123",
  "name":  "Jane Smith",
  "email": "jane@example.com",
  "plan":  "pro"
}

Returns card types, statuses, and team members for the workspace. Use this to get valid values for type, status, and assigneeId when creating or updating cards.

Request

curl https://app.flowcamp.app/api/v1/config \
  -H "Authorization: Bearer fc_live_..."

Response

{
  "cardTypes": [
    { "id": "task",  "name": "Task",  "color": "#6366f1" },
    { "id": "email", "name": "Email", "color": "#0ea5e9" }
  ],
  "statuses": [
    { "id": "idea",        "name": "Idea",        "color": "#475569" },
    { "id": "in_progress", "name": "In Progress", "color": "#f59e0b" },
    { "id": "review",      "name": "Review",      "color": "#8b5cf6" },
    { "id": "done",        "name": "Done",        "color": "#10b981" }
  ],
  "team": [
    { "id": 1, "name": "Jane Smith", "avatar": "JS", "color": "#6366f1" }
  ]
}

Returns all projects owned by the authenticated user.

Request

curl https://app.flowcamp.app/api/v1/projects \
  -H "Authorization: Bearer fc_live_..."

Response

[
  {
    "id":         "proj_abc",
    "name":       "Q3 Launch",
    "created_at": "2025-09-01T10:00:00.000Z"
  },
  // ...
]

Returns all campaigns within a specific project.

Path parameters

Request

curl https://app.flowcamp.app/api/v1/projects/proj_abc/campaigns \
  -H "Authorization: Bearer fc_live_..."

Response

[
  {
    "id":         "camp_xyz",
    "name":       "Email Nurture",
    "color":      "#6366f1",
    "sort_order": 0,
    "created_at": "2025-09-02T08:00:00.000Z"
  },
  // ...
]

Update the name or color of a project. Only fields you include are changed.

Body parameters

Request

curl -X PUT https://app.flowcamp.app/api/v1/projects/1 \
  -H "Authorization: Bearer fc_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "name": "Rebrand 2026", "color": "#ef4444" }'

Response

Returns the updated project object.

Request

curl -X DELETE https://app.flowcamp.app/api/v1/projects/1 \
  -H "Authorization: Bearer fc_live_..."

Response

Returns 204 No Content on success.

Creates a new campaign inside a project.

Path parameters

Body parameters

Request

curl -X POST https://app.flowcamp.app/api/v1/projects/1/campaigns \
  -H "Authorization: Bearer fc_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name":  "Q1 Launch",
    "date":  "2026-03-31",
    "color": "#10b981"
  }'

Response

{
  "id":         42,
  "name":       "Q1 Launch",
  "date":       "2026-03-31",
  "color":      "#10b981",
  "archived":   false,
  "created_at": "2026-01-15T10:00:00.000Z"
}

Returns a campaign and all of its cards (nodes on the board).

Path parameters

Request

curl https://app.flowcamp.app/api/v1/campaigns/camp_xyz \
  -H "Authorization: Bearer fc_live_..."

Response

{
  "id":    "camp_xyz",
  "name":  "Email Nurture",
  "color": "#6366f1",
  "cards": [
    {
      "id":           "card_001",
      "title":        "Welcome email",
      "description":  "Intro email sent on day 1",
      "status":       "in_progress",
      "positionX":    100,
      "positionY":    200,
      "assigneeId":   3,
      "assigneeName": "Jane Smith",
      "dueDate":      "2025-09-10",
      "created_at":   "2025-09-03T09:00:00.000Z"
    },
    // ...
  ]
}

Update any field on a campaign. Only fields you include are changed.

Body parameters

Request

curl -X PATCH https://app.flowcamp.app/api/v1/campaigns/camp_xyz \
  -H "Authorization: Bearer fc_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "archived": true }'

Response

Returns the updated campaign object.

Request

curl -X DELETE https://app.flowcamp.app/api/v1/campaigns/camp_xyz \
  -H "Authorization: Bearer fc_live_..."

Response

Returns 204 No Content on success.

Returns a single card and all its comments.

Path parameters

Request

curl https://app.flowcamp.app/api/v1/cards/card_001 \
  -H "Authorization: Bearer fc_live_..."

Response

{
  "id":          "card_001",
  "title":       "Welcome email",
  "description": "Intro email sent on day 1",
  "status":      "in_progress",
  "type":        "task",
  "priority":    "high",
  "dueDate":     "2025-09-10",
  "assigneeId":  3,
  "positionX":   100,
  "positionY":   200,
  "comments": [
    {
      "id":         "cmt_1",
      "text":       "Subject line approved",
      "author":     "Jane Smith",
      "created_at": "2025-09-04T11:00:00.000Z"
    }
  ],
  "created_at": "2025-09-03T09:00:00.000Z"
}

Creates a new card inside a campaign.

Path parameters

Body parameters

Request

curl -X POST https://app.flowcamp.app/api/v1/campaigns/camp_xyz/cards \
  -H "Authorization: Bearer fc_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "title":       "New card from API",
    "description": "Created via Zapier",
    "status":      "idea",
    "positionX":   400,
    "positionY":   200
  }'

Response

{
  "id":          "card_new",
  "title":       "New card from API",
  "description": "Created via Zapier",
  "status":      "idea",
  "positionX":   400,
  "positionY":   200,
  "created_at":  "2025-10-01T14:30:00.000Z"
}

Updates one or more fields on an existing card. Only fields you send are changed (partial update).

Path parameters

Body parameters

All fields are optional — only the fields you send are updated.

Request

# Move a card to a new position and mark it done
curl -X PUT https://app.flowcamp.app/api/v1/cards/card_001 \
  -H "Authorization: Bearer fc_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "status":    "done",
    "positionX": 600,
    "positionY": 300
  }'

Response

Returns the full updated card object (same shape as GET /cards/:id, without comments).

Permanently deletes a card and its comments. Returns 204 No Content on success.

Request

curl -X DELETE https://app.flowcamp.app/api/v1/cards/card_001 \
  -H "Authorization: Bearer fc_live_..."

Returns all connections (edges) for a campaign.

Request

curl https://app.flowcamp.app/api/v1/campaigns/camp_xyz/connections \
  -H "Authorization: Bearer fc_live_..."

Response

[
  { "id": "e-card_001-card_002", "source": "card_001", "target": "card_002" },
  { "id": "e-card_002-card_003", "source": "card_002", "target": "card_003" }
]

Draws an arrow from one card to another. Both cards must belong to this campaign.

Body parameters

Request

curl -X POST https://app.flowcamp.app/api/v1/campaigns/camp_xyz/connections \
  -H "Authorization: Bearer fc_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "source": "card_001", "target": "card_002" }'

Response

{ "id": "e-card_001-card_002", "source": "card_001", "target": "card_002" }

Removes an arrow between two cards. Returns 204 No Content on success.

Path parameters

Request

curl -X DELETE https://app.flowcamp.app/api/v1/campaigns/camp_xyz/connections/e-card_001-card_002 \
  -H "Authorization: Bearer fc_live_..."