Campaign tools

Helpers around campaigns: filing in folders, renames, a CSV export, the checks the dashboard runs before a send, and AI writing help. Every POST, PATCH and DELETE here needs the send_sms permission and refuses test keys (403 test_key_not_allowed), even the ones that only check or count. Nothing here sends a text.

#Folders

Campaigns are filed in the same folders as your automations, the ones on the Automations page. A folder is identified by its id. File a campaign in a folder with Rename or move a campaign; deleting a folder takes its campaigns out of it and deletes none of them.

#Rename or move a campaign

Changes a campaign’s name or folder, in any status, even after it sent. Send one or both fields. Returns the campaign as saved in data.

Parameters

namestring: The new name, up to 200 characters; longer is cut.
folder_idinteger | null: The id of one of your Automations folders. null takes the campaign out of its folder.

Errors

HTTP	Code	When
400	`NAME_REQUIRED`	`name` is blank.
400	`NOTHING_TO_CHANGE`	Neither field was sent.
400	`FOLDER_INVALID`	`folder_id` is not a whole number.
404	`CAMPAIGN_NOT_FOUND`	No campaign with that id on your account.
404	`FOLDER_NOT_FOUND`	No folder with that id on your account.
500	`CAMPAIGN_META_SAVE_FAILED`	Nothing changed. Try again.

curl -X PATCH "https://api.tryready.com/campaigns/412/meta" \
  -H "X-API-Key: $READY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "October promo (final)",
    "folder_id": 7
  }'

const res = await fetch('https://api.tryready.com/campaigns/412/meta', {
  method: 'PATCH',
  headers: {
    'X-API-Key': process.env.READY_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "October promo (final)",
    "folder_id": 7
  }),
});
const json = await res.json().catch(() => ({}));
if (!res.ok || json.success === false) {
  throw new Error(`${res.status}${json.error_code || json.code ? ' ' + (json.error_code || json.code) : ''}: ${json.error || json.message || res.statusText}`);
}

import os, requests

r = requests.patch(
    "https://api.tryready.com/campaigns/412/meta",
    headers={"X-API-Key": os.environ["READY_API_KEY"]},
    json={
        "name": "October promo (final)",
        "folder_id": 7
    },
    timeout=30,
)
data = r.json() if r.headers.get("content-type", "").startswith("application/json") else {}
if not r.ok or data.get("success") is False:
    raise RuntimeError(f'{r.status_code} {data.get("error_code") or data.get("code") or ""}: {data.get("error") or data.get("message") or r.reason}')

#Export and pre-send checks

#Export campaigns

Your campaigns as a CSV file, newest first, with the columns id, name, message_body, total_recipients, total_sent, total_failed, status, scheduled_at, created_at, total_delivered, total_replies, total_skipped, completed_at, message_body_b, message_variants, media_url and followup_message. The last four are the other A/B versions, the picture link and the follow-up text. The counts are the saved ones, not the live delivery counts. The file stops at 50,000 campaigns with a last line starting # that says so; List campaigns returns all of them. Exports share your account’s limit of 6 bulk exports an hour with the dashboard; past it you get 429 rate_limited. A failed export answers 500 CAMPAIGN_EXPORT_UNAVAILABLE.

curl "https://api.tryready.com/campaigns/export" \
  -H "X-API-Key: $READY_API_KEY"

const res = await fetch('https://api.tryready.com/campaigns/export', {
  headers: {
    'X-API-Key': process.env.READY_API_KEY,
  },
});
const json = await res.json().catch(() => ({}));
if (!res.ok || json.success === false) {
  throw new Error(`${res.status}${json.error_code || json.code ? ' ' + (json.error_code || json.code) : ''}: ${json.error || json.message || res.statusText}`);
}

import os, requests

r = requests.get(
    "https://api.tryready.com/campaigns/export",
    headers={"X-API-Key": os.environ["READY_API_KEY"]},
    timeout=30,
)
data = r.json() if r.headers.get("content-type", "").startswith("application/json") else {}
if not r.ok or data.get("success") is False:
    raise RuntimeError(f'{r.status_code} {data.get("error_code") or data.get("code") or ""}: {data.get("error") or data.get("message") or r.reason}')

Returns:

id,name,message_body,total_recipients,total_sent,total_failed,status,scheduled_at,created_at,total_delivered,total_replies,total_skipped,completed_at
"412","October promo","Hi {{contact.first_name}}, 20% off all week.","1200","1200","21","completed","","2026-10-14T16:02:11.000Z","1179","64","0","2026-10-14T16:40:05.000Z"

#Check a send before you launch

What sending an unsaved campaign now would do: how many it reaches, how many can get it now, how many are in quiet hours, opted out, or not textable, whether the message passes our content check, and whether it reads as time-bound. Free; nothing is saved.

Parameters

Takes the audience parameters of Create a campaign (recipient_filter, segment_id, recipient_rules, recipient_contact_ids), plus scheduled_at, timezone, is_ab_test and message_variants.

message_bodystringRequired: The message to check.

Returns

data.totalinteger: Everyone in the audience.
data.sendable_nowinteger: How many could get it right now.
data.quiet_hoursobject: count in quiet hours now, and next_open_at_by_tz, when each time zone’s quiet hours end.
data.opted_outinteger: Opted out.
data.invalid_or_landlineinteger: Not textable numbers.
data.contentobject: verdict (ok or blocked) and reason. The send checks again.
data.timingobject: kind (evergreen, time_bound or unknown), deadline_at when it is time_bound (otherwise null), and hold_hours, how long a text waiting out quiet hours is held before it goes.

Errors

HTTP	Code	When
400	`invalid_field`	No `message_body`, or a field has the wrong type.
500	`PREFLIGHT_FAILED`	We couldn’t check it. Try again.

curl -X POST "https://api.tryready.com/campaigns/preflight-send" \
  -H "X-API-Key: $READY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message_body": "Hi {{contact.first_name}}, 20% off all week.",
    "recipient_filter": "all"
  }'

const res = await fetch('https://api.tryready.com/campaigns/preflight-send', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.READY_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "message_body": "Hi {{contact.first_name}}, 20% off all week.",
    "recipient_filter": "all"
  }),
});
const json = await res.json().catch(() => ({}));
if (!res.ok || json.success === false) {
  throw new Error(`${res.status}${json.error_code || json.code ? ' ' + (json.error_code || json.code) : ''}: ${json.error || json.message || res.statusText}`);
}

import os, requests

r = requests.post(
    "https://api.tryready.com/campaigns/preflight-send",
    headers={"X-API-Key": os.environ["READY_API_KEY"]},
    json={
        "message_body": "Hi {{contact.first_name}}, 20% off all week.",
        "recipient_filter": "all"
    },
    timeout=30,
)
data = r.json() if r.headers.get("content-type", "").startswith("application/json") else {}
if not r.ok or data.get("success") is False:
    raise RuntimeError(f'{r.status_code} {data.get("error_code") or data.get("code") or ""}: {data.get("error") or data.get("message") or r.reason}')

#Check merge fields

Which merge fields would come out blank, and for how many recipients, before you send. Pass a saved campaign_id, or an unsaved message_body with the audience parameters of Create a campaign. Free; nothing is saved.

Parameters

campaign_idinteger: Check a saved campaign’s message and audience.
message_bodystring: The message to check when you don’t pass campaign_id.

Returns

data.totalinteger: Recipients checked.
data.blank_recipientsinteger: Recipients with at least one blank field.
data.empty[]object[]: Per blank field, most first: token, count and sample_contact_ids.
data.did_you_meanobject[]: Fields you may have meant, when a token looks like a typo.
data.sample_renderobject | null: One recipient’s text as it would go out: contact_id and body.

Errors

HTTP	Code	When
400	`message_required`	Neither `campaign_id` nor `message_body`.
404	`CAMPAIGN_NOT_FOUND`	`campaign_id` isn’t a campaign on your account.

curl -X POST "https://api.tryready.com/campaigns/preflight" \
  -H "X-API-Key: $READY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "campaign_id": 413
  }'

const res = await fetch('https://api.tryready.com/campaigns/preflight', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.READY_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "campaign_id": 413
  }),
});
const json = await res.json().catch(() => ({}));
if (!res.ok || json.success === false) {
  throw new Error(`${res.status}${json.error_code || json.code ? ' ' + (json.error_code || json.code) : ''}: ${json.error || json.message || res.statusText}`);
}

import os, requests

r = requests.post(
    "https://api.tryready.com/campaigns/preflight",
    headers={"X-API-Key": os.environ["READY_API_KEY"]},
    json={
        "campaign_id": 413
    },
    timeout=30,
)
data = r.json() if r.headers.get("content-type", "").startswith("application/json") else {}
if not r.ok or data.get("success") is False:
    raise RuntimeError(f'{r.status_code} {data.get("error_code") or data.get("code") or ""}: {data.get("error") or data.get("message") or r.reason}')

#Check field coverage

Roughly what share of an audience has each merge field filled in, from a sample of the first 3,000 contacts. Takes the audience parameters of Create a campaign. Free; nothing is saved.

Parameters

fieldsstring[]Required: Up to 10 merge fields, like first_name or custom.city. A field we don’t fill is left out of the answer.

Returns

data.sampledinteger: Contacts sampled.
data.fields[]object[]: field, populated (how many have it) and populatedPct.

Errors

HTTP	Code	When
500	`FIELD_COVERAGE_UNAVAILABLE`	We couldn’t check. You can still send.

curl -X POST "https://api.tryready.com/campaigns/field-coverage" \
  -H "X-API-Key: $READY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fields": [
      "first_name",
      "custom.city"
    ],
    "recipient_filter": "all"
  }'

const res = await fetch('https://api.tryready.com/campaigns/field-coverage', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.READY_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "fields": [
      "first_name",
      "custom.city"
    ],
    "recipient_filter": "all"
  }),
});
const json = await res.json().catch(() => ({}));
if (!res.ok || json.success === false) {
  throw new Error(`${res.status}${json.error_code || json.code ? ' ' + (json.error_code || json.code) : ''}: ${json.error || json.message || res.statusText}`);
}

import os, requests

r = requests.post(
    "https://api.tryready.com/campaigns/field-coverage",
    headers={"X-API-Key": os.environ["READY_API_KEY"]},
    json={
        "fields": ["first_name", "custom.city"],
        "recipient_filter": "all"
    },
    timeout=30,
)
data = r.json() if r.headers.get("content-type", "").startswith("application/json") else {}
if not r.ok or data.get("success") is False:
    raise RuntimeError(f'{r.status_code} {data.get("error_code") or data.get("code") or ""}: {data.get("error") or data.get("message") or r.reason}')

Returns:

{
  "success": true,
  "data": {
    "sampled": 1200,
    "fields": [
      { "field": "first_name", "populated": 1104, "populatedPct": 92 },
      { "field": "custom.city", "populated": 300, "populatedPct": 25 }
    ]
  }
}

#Estimate segments

How many segments a message comes to across an audience, with merge fields filled in and your footer on. Takes the audience parameters of Create a campaign. For the price, use quote. Free; nothing is saved.

Parameters

message_bodystringRequired: Up to 3,800 characters.
recipient_filterstringRequired: As in create.
suppress_optoutboolean: true counts without the opt-out line. suppress_sender_signature does the same for your sender name.

Returns

data.contactsinteger: Contacts counted.
data.average_segmentsnumber: Segments per text, on average.
data.longestobject: The longest text: chars and segments.
data.up_toboolean: true when the count includes a footer line, so real texts can come out shorter.

Errors

HTTP	Code	When
400	`invalid_field`	No `message_body` or `recipient_filter`, or a field has the wrong type.
500	`SEGMENT_PREVIEW_FAILED`	We couldn’t estimate it. Try again.

curl -X POST "https://api.tryready.com/campaigns/segment-preview" \
  -H "X-API-Key: $READY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message_body": "Hi {{contact.first_name}}, 20% off all week.",
    "recipient_filter": "all"
  }'

const res = await fetch('https://api.tryready.com/campaigns/segment-preview', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.READY_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "message_body": "Hi {{contact.first_name}}, 20% off all week.",
    "recipient_filter": "all"
  }),
});
const json = await res.json().catch(() => ({}));
if (!res.ok || json.success === false) {
  throw new Error(`${res.status}${json.error_code || json.code ? ' ' + (json.error_code || json.code) : ''}: ${json.error || json.message || res.statusText}`);
}

import os, requests

r = requests.post(
    "https://api.tryready.com/campaigns/segment-preview",
    headers={"X-API-Key": os.environ["READY_API_KEY"]},
    json={
        "message_body": "Hi {{contact.first_name}}, 20% off all week.",
        "recipient_filter": "all"
    },
    timeout=30,
)
data = r.json() if r.headers.get("content-type", "").startswith("application/json") else {}
if not r.ok or data.get("success") is False:
    raise RuntimeError(f'{r.status_code} {data.get("error_code") or data.get("code") or ""}: {data.get("error") or data.get("message") or r.reason}')

#Estimate T-Mobile delivery

How many of an audience are on T-Mobile, and whether that is more than T-Mobile lets your number send in a day, so you know if the campaign will take several days. Takes the audience parameters of Create a campaign, plus phone_number_id or phone_number_ids for the number it sends from. Free; nothing is saved.

Returns

data.appliesboolean: false when no daily T-Mobile limit applies. The answer then has nothing else.
data.capinteger: Texts T-Mobile accepts from you a day.
data.tmobileinteger: Recipients on T-Mobile, out of total (known is how many carriers we know).
data.overboolean: true when they won’t all get it in one day. days is about how many it takes, and warning says it in a sentence.

Errors

HTTP	Code	When
400	`AUDIENCE_TOO_LARGE`	The audience is larger than one campaign can send to.
500	`TMOBILE_ESTIMATE_UNAVAILABLE`	We couldn’t estimate it. Your campaign can still send.

curl -X POST "https://api.tryready.com/campaigns/tmobile-estimate" \
  -H "X-API-Key: $READY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient_filter": "all",
    "phone_number_id": 88
  }'

const res = await fetch('https://api.tryready.com/campaigns/tmobile-estimate', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.READY_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "recipient_filter": "all",
    "phone_number_id": 88
  }),
});
const json = await res.json().catch(() => ({}));
if (!res.ok || json.success === false) {
  throw new Error(`${res.status}${json.error_code || json.code ? ' ' + (json.error_code || json.code) : ''}: ${json.error || json.message || res.statusText}`);
}

import os, requests

r = requests.post(
    "https://api.tryready.com/campaigns/tmobile-estimate",
    headers={"X-API-Key": os.environ["READY_API_KEY"]},
    json={
        "recipient_filter": "all",
        "phone_number_id": 88
    },
    timeout=30,
)
data = r.json() if r.headers.get("content-type", "").startswith("application/json") else {}
if not r.ok or data.get("success") is False:
    raise RuntimeError(f'{r.status_code} {data.get("error_code") or data.get("code") or ""}: {data.get("error") or data.get("message") or r.reason}')

#AI writing help

Each call asks a model for help. Drafts aren’t saved; put what you keep into create or update. These calls share your account’s limit of 30 AI requests every 15 minutes with other AI features; past it you get 429. When AI help is off on our side, a call answers 503 with AI_UNAVAILABLE, AI_BUDGET_EXCEEDED or the code of the budget check; a model answer we couldn’t read is 502 AI_BAD_OUTPUT, and any other failure 500 AI_FAILED.

#Draft a campaign

Writes a campaign from a description: a name, the message, optional A/B versions, an audience stage, a send time if you asked for one, and reply sorting instructions if you asked for them. It costs 1 credit, the price of one text segment at your per-segment rate, taken from your balance only after a draft is made; a failed draft costs nothing, and accounts that don’t pay for texts aren’t charged. Send an Idempotency-Key header to retry without paying twice (Idempotency).

Parameters

descriptionstringRequired: What you want to send, up to 2,000 characters.

Returns

dataobject: name, message, variants, recipient_filter, schedule (date, time, timezone, each null when you didn’t ask) and classification_prompt.
billingobject: charged is 1 when the draft was charged and 0 when it was free. new_balance is about how many one-segment texts your balance still covers after the charge, not money (null when nothing was taken). Also cost. For your balance in money, use Get your balance.

Errors

HTTP	Code	When
400	`DESCRIPTION_REQUIRED`	No description.
400	`DESCRIPTION_TOO_LONG`	Over 2,000 characters.
402	`insufficient_credits`	Your balance doesn’t cover the draft. Nothing was charged.

curl -X POST "https://api.tryready.com/campaigns/ai-build" \
  -H "X-API-Key: $READY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Tell past customers about our fall tune-up special, 15% off through Friday"
  }'

const res = await fetch('https://api.tryready.com/campaigns/ai-build', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.READY_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "description": "Tell past customers about our fall tune-up special, 15% off through Friday"
  }),
});
const json = await res.json().catch(() => ({}));
if (!res.ok || json.success === false) {
  throw new Error(`${res.status}${json.error_code || json.code ? ' ' + (json.error_code || json.code) : ''}: ${json.error || json.message || res.statusText}`);
}

import os, requests

r = requests.post(
    "https://api.tryready.com/campaigns/ai-build",
    headers={"X-API-Key": os.environ["READY_API_KEY"]},
    json={
        "description": "Tell past customers about our fall tune-up special, 15% off through Friday"
    },
    timeout=30,
)
data = r.json() if r.headers.get("content-type", "").startswith("application/json") else {}
if not r.ok or data.get("success") is False:
    raise RuntimeError(f'{r.status_code} {data.get("error_code") or data.get("code") or ""}: {data.get("error") or data.get("message") or r.reason}')

#Vary a message

Rewrites a message with a few interchangeable words written as {a|b|c}; at send time one option is picked for each text, so a big send isn’t identical copies. Numbers, links, merge fields and the opt-out line stay as they are. Free. When the rewrite would drop your opt-out line or come out garbled, you get your message back unchanged with a note.

Parameters

messagestringRequired: Up to 640 characters.

Returns

data.messagestring: The rewritten message, or yours unchanged.
data.variantsinteger: How many different texts it can make.
data.notestring: Only when your message came back unchanged: why.

Errors

HTTP	Code	When
400	`message_required`	No message.
400	`MESSAGE_TOO_LONG`	Over 640 characters.

curl -X POST "https://api.tryready.com/campaigns/ai-spin" \
  -H "X-API-Key: $READY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Hi {{contact.first_name}}, our fall tune-up special is 15% off through Friday. Reply STOP to opt out."
  }'

const res = await fetch('https://api.tryready.com/campaigns/ai-spin', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.READY_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "message": "Hi {{contact.first_name}}, our fall tune-up special is 15% off through Friday. Reply STOP to opt out."
  }),
});
const json = await res.json().catch(() => ({}));
if (!res.ok || json.success === false) {
  throw new Error(`${res.status}${json.error_code || json.code ? ' ' + (json.error_code || json.code) : ''}: ${json.error || json.message || res.statusText}`);
}

import os, requests

r = requests.post(
    "https://api.tryready.com/campaigns/ai-spin",
    headers={"X-API-Key": os.environ["READY_API_KEY"]},
    json={
        "message": "Hi {{contact.first_name}}, our fall tune-up special is 15% off through Friday. Reply STOP to opt out."
    },
    timeout=30,
)
data = r.json() if r.headers.get("content-type", "").startswith("application/json") else {}
if not r.ok or data.get("success") is False:
    raise RuntimeError(f'{r.status_code} {data.get("error_code") or data.get("code") or ""}: {data.get("error") or data.get("message") or r.reason}')

#Review a sent campaign

A grade and suggestions for a campaign, based on its message and its real delivery numbers. Free. Needs the view_reports permission.

Deprecated: use Analyze a campaign’s results, which the dashboard uses and which also reads the replies. This endpoint keeps working, but its grade can differ from that one for the same campaign.

Returns

data.gradestring | null: A to F.
data.summarystring: How it did, in a sentence or two.
data.suggestions[]object[]: title, detail and severity (high, medium, low), most important first.
data.statsobject: The numbers it was based on: recipients, delivered, failed, pending, delivered_pct, failed_pct, chars, segments, has_opt_out.

Errors

HTTP	Code	When
400	`INVALID_ID`	The id isn’t a whole number.
404	`CAMPAIGN_NOT_FOUND`	No campaign with that id on your account.
409	`CAMPAIGN_NOT_SENT`	The campaign hasn’t sent any texts yet, so there’s nothing to grade. Send it, then ask again.

curl -X POST "https://api.tryready.com/campaigns/412/ai-review" \
  -H "X-API-Key: $READY_API_KEY"

const res = await fetch('https://api.tryready.com/campaigns/412/ai-review', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.READY_API_KEY,
  },
});
const json = await res.json().catch(() => ({}));
if (!res.ok || json.success === false) {
  throw new Error(`${res.status}${json.error_code || json.code ? ' ' + (json.error_code || json.code) : ''}: ${json.error || json.message || res.statusText}`);
}

import os, requests

r = requests.post(
    "https://api.tryready.com/campaigns/412/ai-review",
    headers={"X-API-Key": os.environ["READY_API_KEY"]},
    timeout=30,
)
data = r.json() if r.headers.get("content-type", "").startswith("application/json") else {}
if not r.ok or data.get("success") is False:
    raise RuntimeError(f'{r.status_code} {data.get("error_code") or data.get("code") or ""}: {data.get("error") or data.get("message") or r.reason}')

#Analyze a campaign’s results

Whether to send more like it, change it, or stop, from its delivery numbers, replies and a sample of the replies. Free. Needs the view_reports permission.

Returns

data.verdictenum: scale, iterate or stop. grade says the same as A, C or F.
data.headlinestring: The verdict in a sentence. summary repeats it.
data.highlightsstring[]: Up to 4 things that stood out.
data.next_stepsstring[]: Up to 4 things to try.
data.statsobject: recipients, delivered_pct, failed_pct and replies.

Errors

HTTP	Code	When
400	`INVALID_ID`	The id isn’t a whole number.
404	`CAMPAIGN_NOT_FOUND`	No campaign with that id on your account.
409	`CAMPAIGN_NOT_SENT`	The campaign hasn’t sent any texts yet, so there’s nothing to grade. Send it, then ask again.
503	`CAMPAIGN_STATS_UNAVAILABLE`	We couldn’t read its replies. Try again in a minute.

curl -X POST "https://api.tryready.com/campaigns/412/ai-analyze" \
  -H "X-API-Key: $READY_API_KEY"

const res = await fetch('https://api.tryready.com/campaigns/412/ai-analyze', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.READY_API_KEY,
  },
});
const json = await res.json().catch(() => ({}));
if (!res.ok || json.success === false) {
  throw new Error(`${res.status}${json.error_code || json.code ? ' ' + (json.error_code || json.code) : ''}: ${json.error || json.message || res.statusText}`);
}

import os, requests

r = requests.post(
    "https://api.tryready.com/campaigns/412/ai-analyze",
    headers={"X-API-Key": os.environ["READY_API_KEY"]},
    timeout=30,
)
data = r.json() if r.headers.get("content-type", "").startswith("application/json") else {}
if not r.ok or data.get("success") is False:
    raise RuntimeError(f'{r.status_code} {data.get("error_code") or data.get("code") or ""}: {data.get("error") or data.get("message") or r.reason}')