Contact API Documentation - Act On Developer Network

Contact API Documentation

This page summarizes information on the Contact API endpoints that Act-On Software offers to developers and customers. You can click through to find details on each endpoint. For related APIs, take a look at the list APIs and the reporting APIs For questions, please post to our developers forum.

All API calls to Act-On Software should be made to the "https://restapi.actonsoftware.com" base domain.

Contact Methods

The Act-On Contact Methods allow you to create, update and remove contacts in your Act-On lists.

Method Name

Endpoint

Description

Add a contact

POST /api/1/list/{id}/record

Add an individual contact to a list in Act-On.

Get contact fact and score data

GET /api/1/list/{listid}/record/{recordid}/facts

Get a contact record's activity facts and scores.

Get contact record

GET /api/1/list/{listid}/record/{recordid}

Download a contact record from a specific list in your account.

Update a contact by record ID

PUT /api/1/list/{listid}/record/{recordid}

Update a contact in a list by record ID.

Upsert a contact record by email

PUT /api/1/list/{listid}/record?email={emailaddress}

Update an existing record or insert a new contact record by email address.

Delete a contact

DELETE /api/1/list/{listid}/record/{recordid}

Remove an individual contact in a specific list in Act-On.

Get contact record ID based on cookie ID

GET /api/1/list/lookup

Gets a contact record ID from your account based on cookie ID.

Get subscription categories

GET /api/1/subscription/category

Get the account subscription categories.

Get subscription opt-outs by category

GET /api/1/subscription/optout

Download list of records specifically opted out of a specific category

Opt in/Opt out subscription category by email address

PUT /api/1/subscription/optout

Add/remove record to/from specific subscription category.

Get subscription category opt-ins by email

GET /api/1/subscription/category

Get a list of subscription categories a contact has explicitly opted into

Opt in/Opt out multiple subscription categories by email address

PUT /api/1/subscription/setcategories

Add/remove individual records from multiple subscription category by email address.

Get contact from list based on cookie ID or e-mail

GET /api/1/list/lookup/{listID}

Gets contact record from list based on cookie ID and/or email address.