← Tools Reference

Ortto

Ortto integration (Marketing, Data). Imported from open-connector.

API key3 toolshttps://api.au.ap3api.com
POST
ortto_list_people
Retrieve people from Ortto's customer data platform with optional fields, filters, pagination, and sorting.

/v1/person/get

9 parameters
ParamTypeRequiredDescription
limitintegeroptionalThe number of people to return. Ortto allows 1 to 500.
offsetintegeroptionalThe offset for offset-based pagination.
cursor_idstringoptionalThe cursor ID returned by the previous Ortto response.
fieldsarrayoptionalOrtto person field IDs to return for each contact.
qstringoptionalA text search query for matching people.
typestringoptionalThe Ortto person collection to query.
sort_orderstringoptionalSort direction for the selected sort_by_field_id.
sort_by_field_idstringoptionalThe Ortto person field ID to sort by.
filterobjectoptionalAn Ortto filter object copied from the Ortto app or built according to the Ortt…
POST
ortto_get_people_by_ids
Retrieve Ortto contacts by their contact IDs and return the requested fields.

/v1/person/get-by-ids

2 parameters
ParamTypeRequiredDescription
contact_idsarrayrequiredOrtto contact IDs to retrieve.
fieldsarrayoptionalOrtto person field IDs to return for each contact.
POST
ortto_merge_people
Create or update one or more Ortto people using Ortto's person/merge endpoint and merge strategy options.

/v1/person/merge

8 parameters
ParamTypeRequiredDescription
peoplearrayrequiredPeople to create or update. Ortto allows 1 to 100 people per request.
asyncbooleanoptionalWhether Ortto should queue the merge asynchronously.
merge_byarrayoptionalOrtto person field IDs used to identify existing people.
merge_strategynumberoptionalOrtto merge strategy: 1 append only, 2 overwrite existing, or 3 ignore existing.
find_strategynumberoptionalOrtto find strategy: 0 any, 1 next only if previous empty, or 2 all.
skip_non_existingbooleanoptionalWhether to update only existing contacts and skip creating new contacts.
merge_by_alt_fieldsobjectoptionalOptional alternate field mapping for Ortto merge_by identifiers.
suppression_list_field_idstringoptionalOrtto field ID used to compare new contacts against the email suppression list.