Scheduled sends

The campaign's send queue by status

Lists one bucket of the campaign's send queue. status=approval_required returns AI-drafted messages waiting for your decision through POST /business/scheduled-sends/approve or /decline; scheduled is the upcoming queue, each row due at scheduledAt (UTC); sent, skipped, stopped (declined - terminal for that contact) and overwritten (replaced by a newer row through PATCH /business/scheduled-sends/{sendId}) are history. body is the exact message that will go out, including the unsubscribe footer when the campaign appends one. Add channel to narrow to one channel, named exactly as a step's channel is. Only the token owner's own campaigns resolve: a campaign delegated to you, one shared by your team's visibility settings, and a deleted one all answer 404. Rate limit: 30 requests/minute and 1,000/day per token owner, shared by every campaign, scheduled-send, campaign-template and knowledge-hub endpoint.

Errors:

  • 404 CAMPAIGN_NOT_FOUND — No campaign with this id exists, it belongs to another account (including a campaign delegated to you or shared by your team's visibility settings), or it has been deleted.
  • 422 VALIDATION_FAILED — status is missing or not one of the four buckets, channel is not one of the stored channels, or a paging value is out of range; param names the field.
  • 429 RATE_LIMITED — More than 30 campaign requests in a minute, or 1,000 in a day, for this token owner (the bucket is shared by every /business/campaigns, /business/scheduled-sends, /business/campaign-templates and /business/knowledge-hubs call).
  • 500 UNEXPECTED_ERROR — An unhandled failure; the detail stays in our logs and is never returned.

Requires one of the following token scopes: campaigns.

get/business/campaigns/{campaignId}/scheduled-sends

Request

  • Base URL: https://api.tryfuse.ai/api/v1
  • URL: https://api.tryfuse.ai/api/v1/business/campaigns/{campaignId}/scheduled-sends
  • Auth: HTTP basic

Path parameters

campaignIdstring required

The campaign's id (24-character hex ObjectId), as returned by POST /business/campaigns or as the campaignId of a GET /business/campaigns row.

Query parameters

status'approval_required' | 'scheduled' | 'sent' | 'skipped' | 'stopped' | 'overwritten' required

Queue bucket to list: approval_required (AI-drafted sends waiting for your approval), scheduled (queued, goes out at scheduledAt), sent (delivered by Fuse or marked done), skipped (passed over, the contact moved on), stopped (declined, terminal for that contact) or overwritten (replaced by a newer row through PATCH /business/scheduled-sends/{sendId}).

channel'email' | 'linkedin_connection' | 'linkedin_message' | 'linkedin_visit' | 'linkedin_like' | 'inmail' | 'dialer' | 'todo'

Restrict rows to one channel, named exactly as the queue stores it (the same values a step's channel uses): email, linkedin_connection, linkedin_message, linkedin_visit, linkedin_like, inmail, dialer or todo. Omit to include every channel.

limitinteger

Page size, 1-100 (default 25).

pageNuminteger

1-based page number (default 1).

Response

Success

Changes

No recorded changes to this operation across all 1 revision of this API.