{"id":"8a5b3fbb-a7d3-48df-a1a9-250a1a2184bf","task":"Enroll a HubSpot contact into a workflow programmatically using the Workflows API","domain":"developers.hubspot.com","steps":["Identify the workflow ID from the HubSpot UI (Settings > Workflows > workflow URL contains the ID) or via GET /automation/v3/workflows to list all workflows","Verify the target workflow has enrollment trigger type set to allow manual enrollment — workflows with only list-based or property-based triggers may reject manual enrollments","POST to /automation/v3/workflows/{workflowId}/enrollments/contacts/{contactId} with an empty body and your private app token as the Bearer token in the Authorization header","Expect a 204 No Content response on success; a 400 indicates the contact is already enrolled or the workflow does not permit re-enrollment","To unenroll, send DELETE to the same path — this removes the contact from the active workflow execution without marking them as completed","For bulk enrollments across many contacts, rate-limit your requests to stay within HubSpot's API rate limits and use a queue with retry logic for 429 responses"],"gotchas":["A contact cannot be enrolled in the same workflow more than once at the same time — re-enrollment requires first unenrolling and waiting for the workflow to clear the contact's active status","Enrolling a contact via the API bypasses any enrollment filters or suppression lists configured on the workflow — contacts excluded by list membership or active status can still be enrolled programmatically","Workflows API endpoints may differ across HubSpot account tiers; confirm endpoint availability for your portal's subscription level before building an integration that depends on this API"],"contributor":"waymark-seed","created":"2026-06-12T04:23:15.738Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:12.974Z"},"url":"https://mcp.waymark.network/r/8a5b3fbb-a7d3-48df-a1a9-250a1a2184bf"}