Talon.One

Talon.One Customer data platforms API

You can integrate with any customer data platform, or CDP, using the following endpoints designed for third-party tools, rather than your own integration layer. Use these endpoints to automate the creation of coupon and referral codes and deliver them to specific customer segments.

GitHub OpenAPI

Operations 7

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

PUT /cdp/customer_profile/{customerProfileId} Update or create a customer profile from a CDP · Update customer profile (CDP) #
Ask an LLM
“How does my customer data platform push profile attributes into Talon.One?”
“Can a CDP profile sync skip attributes that don't exist yet instead of failing?”
Tell an agent
From CDP {cdpName}, set attributes {attributes} on customer profile {customerProfileId}.
Sync profile {customerProfileId} from CDP {cdpName} to deployment {host}, with skip-unknown-attributes set to {skip}.
PUT /cdp/customer_profile/{customerProfileId}/audiences Change one profile's audiences from a CDP · Update customer profile audiences using external ID (CDP) #
Ask an LLM
“How does my CDP add a single customer to an audience or take them out of one?”
“Can I identify audiences by their ID in my CDP when updating one profile's membership?”
Tell an agent
From CDP {cdpName}, update audience membership of profile {customerProfileId} with {data}.
Add or remove single profile {customerProfileId} from audiences {data} on deployment {host}.
PUT /cdp/customer_profiles/audiences Update audiences for many profiles from a CDP · Update audiences in multiple customer profiles (CDP) #
Ask an LLM
“Can my CDP update audience membership for lots of customers in one call using Talon.One audience IDs?”
“What happens to customer profiles that don't exist yet during a bulk audience update?”
Tell an agent
From CDP {cdpName}, apply bulk audience changes {data} using internal audience IDs.
Update audiences for multiple profiles on deployment {host} with {data}, the v1 bulk call.
PUT /cdp/v2/customer_profiles/audiences Update audiences for many profiles by external ID · Update audiences in multiple customer profiles using external ID (CDP) #
Ask an LLM
“Can my CDP bulk-update audiences using its own external audience IDs?”
“Which bulk audience call lets me reference audiences by the ID from my third-party platform?”
Tell an agent
From CDP {cdpName}, apply v2 bulk audience changes {data} keyed by external audience IDs.
Using external IDs, update many profiles' audiences with {data} on deployment {host}.
POST /cdp/audiences Create an audience from a CDP · Create audience (CDP) #
Ask an LLM
“How do I bring an audience segment from my CDP into Talon.One?”
“Does creating the first audience unlock audience conditions in the Rule Builder?”
Tell an agent
Create audience {audienceName} with external ID {audienceId} from CDP {cdpName}.
Create a new CDP audience {audienceName} (ID {audienceId}) on deployment {host}.
PUT /cdp/audiences/{audienceId} Rename an audience created by a CDP · Update audience (CDP) #
Ask an LLM
“How do I update the name of an audience my CDP created?”
“Can I change an existing third-party audience's details from my CDP?”
Tell an agent
Rename CDP audience {audienceId} to {audienceName}.
Update audience {audienceId} from CDP {cdpName} with name {audienceName}.
DELETE /cdp/audiences/{audienceId} Delete an audience created by a CDP · Delete audience (CDP) #
Ask an LLM
“How do I remove an audience that came from my CDP?”
“Does deleting a CDP audience also drop every customer's membership in it?”
Tell an agent destructive · confirm first
Delete CDP audience {audienceId}.
Remove audience {audienceId} created by CDP {cdpName}, including its profile links.

Documentation

📖
APIReference
https://docs.talon.one/integration-api
📖
Documentation
https://docs.talon.one/docs/dev/integration-api/overview
📖
GettingStarted
https://docs.talon.one/docs/dev/quickstart
📖
APIReference
https://docs.talon.one/management-api
📖
Documentation
https://docs.talon.one/docs/dev/management-api/overview
📖
APIReference
https://docs.talon.one/third-party-api
📖
Documentation
https://docs.talon.one/docs/dev/technology-partners/overview
📖
Documentation
https://docs.talon.one/docs/dev/technology-partners/shopify/integrate-with-shopify
📖
Documentation
https://docs.talon.one/docs/dev/get-started/webhooks
📖
APIReference
https://docs.talon.one/outbound-notifications

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/talon-one/refs/heads/main/openapi/talon-one-customer-data-platforms-api-openapi.yml

Other Resources

🔗
PostmanCollection
https://raw.githubusercontent.com/api-evangelist/talon-one/refs/heads/main/collections/talon-one.postman_collection.json
🔗
OpenCollection
https://raw.githubusercontent.com/api-evangelist/talon-one/refs/heads/main/collections/talon-one.opencollection.json
🔗
Postman
https://www.postman.com/talonone-rnd/workspace/talon-one/overview
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/talon-one/refs/heads/main/data-model/talon-one-data-model.yml
🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/talon-one/refs/heads/main/asyncapi/talon-one-webhooks.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/talon-one:talon-one-customer-data-platforms-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

talon-one-customer-data-platforms-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: ''
  title: Third-party Customer data platforms API
  description: Use the Third-party API to exchange data between Talon.One and one of the supported technology partners.
servers:
- url: https://integration.talon.one
security:
- ApiKeyAuth: []
tags:


# --- truncated at 32 KB (96 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/talon-one/refs/heads/main/openapi/talon-one-customer-data-platforms-api-openapi.yml