Run Account Health Check

POST

api

account-health

runs

curl --request POST \
  --url https://api.sequenzy.com/api/v1/account-health/runs \
  --header 'Authorization: Bearer <token>'

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.sequenzy.com/api/v1/account-health/runs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sequenzy.com/api/v1/account-health/runs",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sequenzy.com/api/v1/account-health/runs"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.sequenzy.com/api/v1/account-health/runs")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "run": {
    "id": "run_789",
    "trigger": "manual",
    "status": "queued",
    "scheduledFor": "2026-10-13T10:02:11.000Z",
    "createdAt": "2026-10-13T10:02:11.000Z"
  },
  "alreadyInProgress": false
}

{
  "error": "Account health checks run for workspaces with more than 1,000 active subscribers that sent email in the last 14 days.",
  "code": "NOT_ELIGIBLE"
}

{
  "error": "A check ran in the last 10 minutes. Try again in 6 minute(s).",
  "code": "RATE_LIMITED",
  "retryAfterSeconds": 342
}

Queue an account health check now. It usually finishes within a minute. Poll Get Account Health until runInProgress is false to read the result. If a check is already queued or running, that check is returned with alreadyInProgress: true instead of starting another one. Manual checks may lay out inactive draft sequences (no emails written) when autonomy is draft_fixes, and never send the report email. Requires the sequences:write scope. Viewers cannot run checks.

Request

curl -X POST "https://api.sequenzy.com/api/v1/account-health/runs" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response fields

object

The queued or in-flight check: id, trigger, status, scheduledFor and createdAt.

boolean

true when an existing check was returned.

{
  "success": true,
  "run": {
    "id": "run_789",
    "trigger": "manual",
    "status": "queued",
    "scheduledFor": "2026-10-13T10:02:11.000Z",
    "createdAt": "2026-10-13T10:02:11.000Z"
  },
  "alreadyInProgress": false
}

{
  "error": "Account health checks run for workspaces with more than 1,000 active subscribers that sent email in the last 14 days.",
  "code": "NOT_ELIGIBLE"
}

{
  "error": "A check ran in the last 10 minutes. Try again in 6 minute(s).",
  "code": "RATE_LIMITED",
  "retryAfterSeconds": 342
}

A 429 means a manual check ran in the last 10 minutes, or the latest check finished less than a day ago and left findings open (rerunning would only repeat them). Resolve, snooze or dismiss the open findings, or wait retryAfterSeconds before retrying. A 409 does not change on retry until the company has more than 1,000 active subscribers and has sent email in the last 14 days.

Run Account Health Check

curl --request POST \
  --url https://api.sequenzy.com/api/v1/account-health/runs \
  --header 'Authorization: Bearer <token>'

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.sequenzy.com/api/v1/account-health/runs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sequenzy.com/api/v1/account-health/runs",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sequenzy.com/api/v1/account-health/runs"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.sequenzy.com/api/v1/account-health/runs")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "run": {
    "id": "run_789",
    "trigger": "manual",
    "status": "queued",
    "scheduledFor": "2026-10-13T10:02:11.000Z",
    "createdAt": "2026-10-13T10:02:11.000Z"
  },
  "alreadyInProgress": false
}

{
  "error": "Account health checks run for workspaces with more than 1,000 active subscribers that sent email in the last 14 days.",
  "code": "NOT_ELIGIBLE"
}

{
  "error": "A check ran in the last 10 minutes. Try again in 6 minute(s).",
  "code": "RATE_LIMITED",
  "retryAfterSeconds": 342
}

​Request

​Response fields

Request

Response fields