Stages API: Create and Manage Pipeline Stages

Stages represent steps in your ReachOwl outreach pipeline. Create, reorder, and delete stages to organize contact progress through your funnel.

Stages are the steps in your ReachOwl outreach pipeline. Use these endpoints to list stages for a team, view a single stage, create new stages, reorder them, or delete stages you no longer need.

List stages

curl -X GET "https://api.reachowl.com/api/v1/stages?team_id=123" \
  -H "Authorization: Bearer <token>"

team_id · integer · required

The team whose stages you want to list.

Get a single stage

curl -X GET https://api.reachowl.com/api/v1/stages/456 \
  -H "Authorization: Bearer <token>"

Create a stage

curl -X POST https://api.reachowl.com/api/v1/stages \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Connected",
    "order": 2
  }'

name · string · required

Display name of the stage.

order · integer · required

Position of the stage in the pipeline. Lower values appear first.

Reorder stages

Send the full array of stages with updated order values. The API will persist the new sequence.

curl -X PUT https://api.reachowl.com/api/v1/stages \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '[
    {"id": 1, "order": 0},
    {"id": 2, "order": 1},
    {"id": 3, "order": 2}
  ]'

id · integer · required

Stage identifier.

order · integer · required

New position for the stage.

Delete a stage

curl -X DELETE https://api.reachowl.com/api/v1/stages/456 \
  -H "Authorization: Bearer <token>"