Base calls for managing contacts

You can use the following base calls to perform CRUD actions on user accounts (contact objects). The sections below list a base call for common account types. DataTable APIs can be POST or GET.

Agent

/API/DataTable/v2.2/Contacts.Agent.Default**

Billing account

/API/DataTable/v2.2/Contacts.Billing-account.Default

Client

/API/DataTable/v2.2/Contacts.Client.Default

Company

/API/DataTable/v2.2/Contacts.Company.Default

Model

/API/DataTable/v2.2/Contacts.Model.Default

OAuth Client Application

/API/DataTable/v2.2/Contacts.OAuth.Default

Source

/API/DataTable/v2.2/Contacts.Source.Default

Source agent

/API/DataTable/v2.2/Contacts.Source-agent.Default

Staff

/API/DataTable/v2.2/Contacts.Staff.Default

Search all accounts

If you need to retrieve information about an account and do not know the account type (client, staff, source, etc.) that it belongs to, you can use the Contacts.All query.

/API/DataTable/v2.2/Contacts.All

For example, the following call lists the account details for Stephen Grant, regardless of the type of user account Stephen has.

/API/DataTable/v2.2/Contacts.All:[email protected]

By default, if you use the Contacts.All query, you can use one of the following fields to retrieve a record:

  • RecordID
  • Unique identifier (CoreField.Identifier)
  • Login ID (CoreField.LoginID)
  • Email address (CoreField.Email1)

The read, update, and delete operations only work if only one contact matches the search criteria.

If you want to add another field to the list of accepted Contacts.All queries, your Orange Logic administrator can submit a support request and include this ID in the description: 22M0ZH.