AFI
Attentive
Attentive is an SMS and email marketing platform for brands. AFI subscribes contacts to Attentive via the Subscriptions API (v1/subscriptions), sending form data as JSON with a Bearer API key.
What you’ll need
- An active Attentive account.
- An API Key from the Attentive Developer Portal.
- A Sign-up Source ID from the Attentive platform (Sign-up Units tab).
- The Advanced Form Integration plugin installed and activated.
Save your Attentive API key
- Log in to Attentive and open the API Keys section of the Developer Portal.
- Generate a Server-to-Server API key and copy the value.
- In WordPress, go to AFI → Settings → Attentive.
- Paste the API Key. Optionally override the API base URL if Attentive provides a regional endpoint.
- Click Save Changes.
Create the integration
- Go to AFI → Add New.
- Give the integration a name.
- Under Trigger, pick your form plugin and form.
- Under Action → Platform, select Attentive.
- In Task, choose Subscribe User.
- Select the saved Attentive credentials.
- Map form fields to Attentive fields.
- Click Save Integration.
Tasks supported
Subscribe User
POSTs a JSON payload to https://api.attentivemobile.com/v1/subscriptions with Authorization: Bearer {api_key}. At least phone or email is required. Phone must be in E.164 format (e.g. +15555555555).
| Field | Field key | Required | Notes |
|---|---|---|---|
| Phone | phone |
No* | E.164 format (e.g. +15555555555). *At least phone or email is required. |
email |
No* | *At least phone or email is required. | |
| Sign-up Source ID | signUpSourceId |
Yes** | Found in Sign-up Units tab. **Or both Locale and Subscription Type must be provided. |
| Client User ID | clientUserId |
No | External identifier |
| Shopify ID | shopifyId |
No | |
| Klaviyo ID | klaviyoId |
No | |
| Custom Identifiers | customIdentifiers |
No | JSON array, e.g. [{"name":"customKey","value":"customValue"}] |
| Subscription Type | subscriptionType |
No | MARKETING or TRANSACTIONAL. Required if no Sign-up Source ID. |
| Locale | locale |
No | e.g. en-US. Required if no Sign-up Source ID. |
| Single Opt-In | singleOptIn |
No | true/false. Skips “Reply Y” message. Contact CSM before enabling. |
Troubleshooting
Subscribers not appearing
- Check AFI → Log for the HTTP response code and body.
- Verify the API Key is correct and has not expired.
- Ensure at least phone or email is provided and not empty.
- Phone numbers must be in E.164 format with country code.
“Attentive requires either a Sign-up Source ID, or both Locale and Subscription Type”
Map the Sign-up Source ID field, or map both Locale and Subscription Type.