Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Tenfold Contact Lists API

Contact list management (BETA)

Tenfold Contact Lists API is one of 8 APIs that Tenfold publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Contact Lists. The published artifact set on APIs.io includes an OpenAPI specification and authentication docs.

This API exposes 7 operations across 4 paths. It is described by OpenAPI 3.0.3, at version 2.0.

Requests are made against 2 base URLs: https://api.tenfold.com, https://api-canary.tenfold.com.

7 operations 4 paths 0 schemas 2 DELETE2 GET2 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
2.0
Base URL
https://api.tenfold.com
Authentication
OAuth 2.0, OAuth 2.0, HTTP Bearer
Resource Areas
1

Authentication & Security 3

Tenfold Contact Lists API declares 3 security schemes for authenticating requests. It supports OAuth 2.0 (oauth2Password) using the password flow. It supports OAuth 2.0 (oauth2ClientCredentials) using the clientCredentials flow. It accepts HTTP bearer tokens (JWT) (bearerJWT). By default, every request must be authenticated.

  • oauth2Password — OAuth 2.0 Resource Owner Password Credentials grant (v1/v2)
  • oauth2ClientCredentials — OAuth 2.0 Client Credentials grant
  • bearerJWT — JWT access token obtained from /v2/users/login, presented as "Authorization: Bearer JWT ".

Paths & Operations 7

Across 4 paths, the API surfaces 7 operations — 2 DELETE, 2 GET, 2 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Contact Lists 7

Contact list management (BETA)

GET
/v2/contact-lists
List the user's contact lists (BETA)
listContactLists → 200
POST
/v2/contact-lists
Create a new contact list (BETA)
createContactList → 201
GET
/v2/contact-lists/{listId}
Retrieve a specific contact list (BETA)
getContactList 1 param → 200404
PUT
/v2/contact-lists/{listId}
Update a contact list (BETA)
updateContactList 1 param → 200
DELETE
/v2/contact-lists/{listId}
Delete a contact list (BETA)
deleteContactList 1 param → 204
POST
/v2/contact-lists/{listId}/contacts
Add a contact to a list (BETA)
addContactToList 1 param → 201
DELETE
/v2/contact-lists/{listId}/contacts/{contactId}
Remove a contact from a list (BETA)
removeContactFromList 2 params → 204

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

tenfold-contact-lists-api-openapi.yml Raw ↑

Other APIs Tenfold publishes across the network.

Tenfold Analytics API
Tenfold Authentication API
Tenfold Calls API
Tenfold CRM Records API
Tenfold Organizations API
Tenfold Tracking API
Tenfold Users API