Propose enrolling the person in the outbound engine
POST /api/v1/actions/{action}/enroll
Checks everything the engine will check, then puts it in front of a person: the post is marked Good (the engine refuses to enrol anyone at a company with no Good post), the address is verified and on the person's company domain, nobody answered the thread, the email follows the rules (short, plain, no link), and the connected sequence really sends this email (its first step must use {{custom.draft_subject}} and {{custom.draft_body}}). A refusal says which. Approving it, in the app, adds the company with the Good post, adds the person, previews exactly what they would receive and enrols them. Needs the outbound engine connected (get_action_settings).
A full-access key (ss_sk_…), or an editor or owner signed in.
Parameters
| Name | Type | Description |
|---|---|---|
action requiredpath |
string | The action's id. |
Returns
{ data: Action (status proposed), approval }
Example
curl -X POST "https://sniffington.com/api/v1/actions/{action}/enroll" \
-H "Authorization: Bearer $SCOUT_API_KEY"