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

Talon.One Customer Profiles API

Integration API - sync customer profile data and read inventory.

Talon.One Customer Profiles API is one of 13 APIs that Talon.One publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Customer Profiles. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 3 operations across 3 paths, and defines 3 schemas. It is described by OpenAPI 3.0.3, at version 1.0.

Requests are made against a single base URL, https://yourbaseurl.talon.one.

3 operations 3 paths 3 schemas 1 DELETE1 GET1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.0
Base URL
https://yourbaseurl.talon.one
Authentication
API Key, API Key
Contact
Resource Areas
1

Authentication & Security 2

Talon.One Customer Profiles API declares 2 security schemes for authenticating requests. An API key is passed in the header as Authorization (integrationKey). An API key is passed in the header as Authorization (managementKey). By default, every request must be authenticated.

  • integrationKey — Integration API key with the ApiKey-v1 prefix, e.g. header "Authorization: ApiKey-v1 ".
  • managementKey — Management API key with the ManagementKey-v1 prefix, e.g. header "Authorization: ManagementKey-v1 ".

Paths & Operations 3

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

Customer Profiles 3

Integration API - sync customer profile data and read inventory.

PUT
/v2/customer_profiles/{integrationId}
Update customer profile
updateCustomerProfileV2 1 param body → 200
GET
/v1/customer_profiles/{integrationId}/inventory
Get customer's loyalty and coupon inventory
getCustomerInventory 1 param → 200
DELETE
/v1/customer_data/{integrationId}
Delete customer's personal data
deleteCustomerData 1 param → 204

Schemas 3

The contract defines 3 schemas that model the data the API accepts and returns. The most detailed are Effect (4 properties), CustomerProfileIntegrationResponseV2 (2 properties), CustomerProfileUpdate (2 properties). Each schema is shown below with its type and property counts.

Effect
object
A single effect returned by the rules engine (e.g. setDiscount, acceptCoupon, addLoyaltyPoints).
4 properties
CustomerProfileUpdate
object
2 properties
CustomerProfileIntegrationResponseV2
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

talon-one-customer-profiles-api-openapi.yml Raw ↑

Other APIs Talon.One publishes across the network.

Talon.One Account API
Talon.One Applications API
Talon.One Attributes API
Talon.One Audiences API
Talon.One Campaigns API
Talon.One Collections API
Talon.One Coupons API
Talon.One Customer Sessions API
Talon.One Events API
Talon.One Exports API
Talon.One Loyalty API
Talon.One Referrals API