Sync sequence bulk account pool

Synchronize the sequence’s selected eligible sender accounts with its configured bulk-email provider. Requires an authenticated user session; developer API keys are blocked for this route.

POST/api/sequences/{sequence_id}/sync-account-pool

HTTP referenceScope authenticated user sessionUpdated September 27, 2026

This page documents the canonical HTTP contract for this endpoint.

This action writes provider/account-pool configuration and performs a provider synchronization. It is session-only. Use List sender accounts to inspect sender identities before choosing selected account IDs.

Path parameters

sequence_idrequired
string
Sequence identifier.

Name	Type	Description
sequence_idrequired	string	Sequence identifier.

Query parameters

actorUserId · optional
string
Optional active same-organization actor override.

Name	Type	Description
actorUserId	string	Optional active same-organization actor override.

Body parameters

accountSelection · optional
string
Selection mode: all_eligible (default) or selected.
selectedAccounts · optional
array<string>
Provider account identifiers; required when accountSelection is selected.
refresh · optional
boolean
Refresh current provider configuration before sync; defaults to true.

Name	Type	Description
accountSelection	string	Selection mode: all_eligible (default) or selected.
selectedAccounts	array<string>	Provider account identifiers; required when accountSelection is selected.
refresh	boolean	Refresh current provider configuration before sync; defaults to true.

Errors

Status	Meaning
401	An authenticated user session is required.
400	selectedAccounts is required for selected mode.
404	Sequence not found.
409	Bulk delivery, provider, campaign, or eligible-account configuration is not ready.

Example

bash

curl -X POST "https://app.autotouch.ai/api/sequences/67c4a4f7b4dd8f2d4999f014/sync-account-pool" \
  -H "Authorization: Bearer $AUTOTOUCH_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"accountSelection":"all_eligible","refresh":true}'

Request body

json

{
  "accountSelection": "all_eligible",
  "refresh": true
}

Response example

json

{
  "success": true,
  "sequenceId": "67c4a4f7b4dd8f2d4999f014",
  "provider": "smartlead",
  "campaignId": "campaign-123",
  "accountSelection": "all_eligible",
  "selectedAccounts": [],
  "eligibleAccountsSnapshot": [],
  "eligibleAccountCount": 0,
  "poolSync": {
    "success": true
  }
}