Shape your requests
Learn how arguments, pagination, filtering, field selection, responses, and errors work with the ActiveCampaign API on MindCloud.
Once your first ActiveCampaign request works, use this page to shape real production requests. MindCloud keeps the app-specific API details behind one REST format, so you can control arguments, pagination, filtering, fields, and errors without learning a separate convention for every provider. If you have not connected ActiveCampaign yet, start with Connect to ActiveCampaign.
Arguments
Arguments are the inputs an action needs. Pass them as flat fields beside the Universal API fields: query parameters for read and delete actions, JSON body fields for create and update actions. Each ActiveCampaign action page documents its exact argument keys, types, and which ones are required. Keys are case-sensitive, and requests with missing or invalid required arguments fail instead of guessing.
Request format
The REST format is intentionally plain. Choose a ActiveCampaign action, call its Universal API URL, authenticate with your MindCloud API Key, and include the connection and action fields in the correct lane for the HTTP method.
| Piece | Where it goes |
|---|---|
| Action fields | Query parameters for GET and DELETE; JSON body fields for POST, PUT, and PATCH. |
connectionId | Query string for reads and deletes; body for creates and updates. |
limit, offset, where, sort, fields | Universal API controls; always query parameters, never body fields. |
Pagination
Paginated list actions accept limit and offset as query parameters. Some providers use page numbers, some use cursors; MindCloud translates your request into whatever ActiveCampaign expects, so you page through results the same way on every app. Start at offset=0, add limit to the offset after each page, and stop when a page returns fewer rows than you asked for.
curl --request GET \
--url "https://connect.mindcloud.co/v1/universal/activeCampaign/latest/actions/get-account" \
--header "Authorization: Bearer $MINDCLOUD_API_KEY" \
--get \
--data-urlencode "connectionId=$CONNECTION_ID" \
--data-urlencode "limit=25" \
--data-urlencode "offset=0"These ActiveCampaign actions support pagination:
- List Accounts
- List Automations
- List Contact Automations
- List Contacts
- List Custom Field Values
- List Deal Stages
- List Deals
- List Lists
- List Pipelines
Filtering
Filterable list actions accept a where query parameter written as an RSQL expression. MindCloud translates it into the filtering shape ActiveCampaign supports, and the filterable fields are listed on each action page.
| Operator | Meaning | Example |
|---|---|---|
== / != | Equals / does not equal | status==active |
> >= < <= | Comparisons | createdAt>=2026-01-01 |
=like= | Contains text, with * wildcards | name=like=*dan* |
Combine conditions with ; for AND and , for OR: status==active;createdAt>=2026-01-01.
These ActiveCampaign actions support filtering:
Sorting
Sortable list actions accept a sort query parameter: a comma-separated list of fields, with a - prefix for descending order, such as sort=-createdAt,name. MindCloud maps it into the sorting format ActiveCampaign supports, and the sortable fields are listed on each action page.
These ActiveCampaign actions support sorting:
Field selection
Use the fields query parameter to return only the response fields your code reads, with dot notation for nested objects: fields=id,name,profile.email. Selection is applied to each row in data after the response is mapped, and id is kept whenever it exists so rows stay identifiable.
Responses and errors
Every ActiveCampaign response is mapped into the same public envelope before it reaches your code: success, your rows in a data array (single-row actions return an array with one item), and optional meta. Failed requests return success: false with a stable code to branch on and a human-readable message:
{
"success": false,
"code": "CONNECTION_APP_MISMATCH",
"message": "Connection \"conn_123\" is not configured for this app."
}Check the HTTP status first: 401 or 403 for authentication and authorization, 400 for invalid request shape, and 5xx when MindCloud cannot complete the action upstream. Most failures come from a missing API Key, a missing or mismatched connection, or arguments that do not match the action page.