API reference/Outreach/Flows

.md

Delete a flow

Deletes a flow of the workspace. People assigned to it follow no flow anymore; sequences that already run keep their steps. Ready-made flows cannot be deleted.

DELETEhttps://mysdr.app/api/v1/outreach/flows/{key}

A flow is the skeleton of a sequence without its texts: which steps, on which channel, in which order and branch, after how many days. Any channel in any order: emails you send yourself, a call or another human task, and LinkedIn steps, with or without a LinkedIn invite, for example an email, a call and an email, or a call, a LinkedIn message and an email. A flow with nothing on LinkedIn (only emails and human tasks) needs no LinkedIn account, no LinkedIn profile of the person (an email address does) and no month of LinkedIn outreach (uses_linkedin). You write the texts per person when you start (POST /outreach/linkedin/sequences with flow and texts, or start_flow on the assistant server), and the sequence then has exactly the steps of the flow. There are ready-made flows (invite_note_then_message, invite_then_message, invite_note_two_follow_ups, invites_only, invite_then_inmail, like_then_invite, email_then_invite, email_then_call, emails_only) and the workspace’s own, at most 100. These routes are the tools list_flows, get_flow, save_flow, delete_flow and assign_flow of the assistant server. Free.

Authentication#

Send Authorization: Bearer gtk_…. Create the key under API keys in the menu. Every gtk_ key can call these routes, also while the Signals API is closed. A missing, invalid or revoked key is 401.

Path parameters#

  • key string · required — The key of the flow (cfo_after_funding, or a ready-made one).

Response#

  • key string · required — The key you sent.
  • removed boolean · required — Always true.
  • unassigned integer · required — How many people followed it.
  • note string · required — What it means for campaigns that followed it.
  • dashboard_url string · required — The flows in mySDR.

Credits#

Free. This call never uses credits.

Errors#

  • 400 invalid_request — A key that is not valid, or of a ready-made flow.
  • 404 not_found — The workspace has no flow with this key.
  • 401 authentication_error — The Authorization header is missing, or the key is unknown or revoked.
  • 403 permission_error — API access is not part of your plan, or your account is suspended.
  • 429 rate_limit_error — More than 60 requests per minute, or more than 3 at the same time, on one key. Wait for the Retry-After header.
  • 503 service_unavailable — The API is temporarily unavailable. Retry later.
  • 500 internal_error — Something went wrong on our side.

Example

DELETE/outreach/flows/{key}
curl -X DELETE "https://mysdr.app/api/v1/outreach/flows/cfo_after_funding" \
  -H "Authorization: Bearer $MYSDR_API_KEY"
Response
{
  "key": "cfo_after_funding",
  "removed": true,
  "unassigned": 0,
  "note": "Running sequences keep their steps.",
  "dashboard_url": "https://mysdr.app/en/gtm/flows"
}