How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Talon.One Braze API

[Braze](https://www.braze.com/) is a customer engagement platform to manage customer-centric interactions between consumers and brands in real-time.Use these endpoints to automate the creation of coupon and referral codesand deliver them to specific customer segments. To send requests to these endpoints, use the[connected content feature](https://www.braze.com/docs/user_guide/personalization_and_dynamic_content/connected_content/connected_content_retries) in Braze.For more information, see our integration examples in [the developer docs](https://docs.talon.one/docs/dev/technology-partners/braze).

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

Tagged areas include Braze. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, API documentation, and a getting-started guide.

This API exposes 4 operations across 4 paths, and defines 88 schemas. It is described by OpenAPI 3.2.0.

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

4 operations 4 paths 88 schemas 4 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
Base URL
https://yourbaseurl.talon.one
Authentication
API Key, HTTP Basic
Resource Areas
1

Authentication & Security 2

Talon.One Braze API declares 2 security schemes for authenticating requests. An API key is passed in the header as Authorization (ApiKeyAuth). It accepts HTTP basic authentication (ApiKeyBasicAuth). By default, every request must be authenticated.

  • ApiKeyAuth — To authenticate to use these endpoints, create a Third-party API key in the Campaign Manager: 1. Sign in to the Campaign Manager, and open the [Application](ht…
  • ApiKeyBasicAuth — To authenticate to use these endpoints, create a Third-party API key in the Campaign Manager: 1. Sign in to the Campaign Manager, and open the [Application](ht…

Paths & Operations 4

Across 4 paths, the API surfaces 4 operations — 4 POST. Each is listed below with its method, path, parameters, and response codes.

Braze 4

Braze is a customer engagement platform to manage customer-centric interactions between consumers and brands in real-time. Use these endpoints to automate the creation of coupon a…

POST
/braze/referral
Create referral (Braze)
braze/createReferral 1 param body → 200400401404429
POST
/braze/coupon
Create coupon (Braze)
braze/createCoupon body → 200400401404429
POST
/braze/coupon_reservation
Create coupon reservation (Braze)
braze/createCouponReservation body → 200400401404429
POST
/braze/event
Track event (Braze)
braze/trackEvent 1 param body → 200400401404429

Schemas 88

The contract defines 88 schemas that model the data the API accepts and returns. The most detailed are BrazeCouponRequest (15 properties), IntegrationStateV2 (14 properties), cartItem (14 properties), newCampaign (13 properties). Each schema is shown below with its type and property counts.

id
integer
Unique ID for this entity.
referralCreatedEffectProps
object
The properties specific to the "referralCreated" effect. This gets triggered whenever a validated rule contained a "create referral" effect, and a referral cod…
1 property 1 required
addLoyaltyPointsEffectProps
object
The properties specific to the "addLoyaltyPoints" effect. This gets triggered whenever a validated rule contained an "add loyalty" effect. These points are aut…
12 properties 6 required
identifier
string
The identifier of the request. Providing a new value sends a new event to Talon.One. Providing an existing value retrieves the existing event of that id. In ge…
loyalty
object
Customer specific information about loyalty points.
2 properties 1 required
ledgerEntry
effect
updateLoyaltyCard
object
1 property 1 required
loyaltyCard
showNotificationEffectProps
object
The properties specific to the "showNotification" effect. This gets triggered whenever a validated rule contained a "show notification" effect.
3 properties 3 required
setDiscountPerAdditionalCostPerItemEffectProps
object
The properties specific to the "setDiscountPerAdditionalCostPerItem" effect. This gets triggered whenever a validated rule contained a "set discount per additi…
7 properties 5 required
additionalCost
object
1 property
campaign
inventoryReferral
entity
object
2 properties 2 required
addFreeItemEffectProps
object
The properties specific to the "addFreeItem" effect. This gets triggered whenever a validated rule contained an "add free item" effect.
2 properties 2 required
BrazeCouponResponse
object
13 properties
customerProfile
event
BrazeTrackEventRequest
rollbackDeductedLoyaltyPointsEffectProps
object
The properties specific to the "rollbackDeductedLoyaltyPoints" effect. This effect is triggered whenever a previously closed session is cancelled and a deductL…
8 properties 6 required
ledgerInfo
object
7 properties
errorEffectProps
object
Whenever an error occurred during evaluation, we return an error effect. This should never happen for rules created in the rule builder.
1 property 1 required
setDiscountEffectProps
object
The properties specific to the "setDiscount" effect. This gets triggered whenever a validated rule contained a "set discount" effect. This is a discount that s…
4 properties 2 required
ReferralResponse
object
12 properties
applicationEntity
object
1 property 1 required
returnedCartItem
object
2 properties 1 required
rollbackReferralEffectProps
object
The properties specific to the "rollbackReferral" effect. This gets triggered whenever previously closed session is now cancelled and a referral redemption was…
1 property 1 required
customerProfileID
string
The integration ID of the customer profile. If the customer profile does not exist, it will be created.
rejectReferralEffectProps
object
The properties specific to the "rejectReferral" effect. This gets triggered whenever the referral code was rejected. See rejectionReason for more info on why.
5 properties 2 required
couponRejectionReason
object
Holds a reference to the campaign, the coupon and the reason for which that coupon was rejected. Should only be present when there is a 'rejectCoupon' effect.
3 properties 3 required
referralRejectionReason
object
Holds a reference to the campaign, the referral and the reason for which that referral was rejected. Should only be present when there is a 'rejectReferral' ef…
3 properties 3 required
integrationEntity
object
2 properties 2 required
setDiscountPerAdditionalCostEffectProps
object
The properties specific to the "setDiscountPerAdditionalCost" effect. This gets triggered whenever a validated rule contained a "set per additional cost discou…
5 properties 4 required
cartItem
object
14 properties 2 required
attributeValuePairs
object
Property to set the attributes of your choice to the values of your choice. You can use [built-in attributes](https://docs.talon.one/docs/dev/concepts/attribut…
loyaltyProgramLedgers
object
Customer specific information about loyalty points.
5 properties 4 required
newReturn
object
1 property 1 required
willAwardGiveawayEffectProps
object
The properties specific to the "awardGiveaway" effect when the session is not closed yet. This effect replaces "awardGiveaway" only when updating a session wit…
3 properties 3 required
ruleFailureReason
object
Details about why a rule failed.
12 properties 5 required
rejectCouponEffectProps
object
The properties specific to the "rejectCoupon" effect. This gets triggered whenever the coupon was rejected. See rejectionReason for more info on why.
5 properties 2 required
limitConfig
object
4 properties 3 required
importEntity
object
1 property 1 required
accountEntity
object
1 property 1 required
effectProps
object
integrationEvent
effectEntity
object
Definition of all properties that are present on all effects, independent of their type.
6 properties 5 required
TrackEventRequest
object
4 properties 3 required
setDiscountPerItemEffectProps
object
The properties specific to the setDiscountPerItem effect, triggered whenever a validated rule contained a "set per item discount" effect. This is a discount th…
10 properties 3 required
codeGeneratorSettings
object
2 properties 2 required
errorResponseWithStatus
object
3 properties
entityWithTalangVisibleID
object
2 properties 2 required
BrazeCouponRequest
object
15 properties 4 required
ReferralRequest
object
8 properties 3 required
couponCreatedEffectProps
object
The properties specific to the "couponCreated" effect. This gets triggered whenever a validated rule contained a "create coupon" effect, and a coupon was creat…
2 properties 2 required
couponValue
object
1 property
return
showBundleMetadataEffectProps
object
The properties specific to the "ShowBundleMetadata" effect. This effect contains information that allows you to associate the discounts from a rule in a bundle…
3 properties 3 required
newCampaign
object
13 properties 5 required
coupon
IntegrationStateV2
object
Contains all entities that might interest Talon.One integrations. This is the response type returned by the v2 PUT customersession endpoint.
14 properties 3 required
giveaway
acceptReferralEffectProps
object
The properties specific to the "acceptReferral" effect. TThis gets triggered whenever the referral code is valid and all other conditions in the rules of its c…
1 property 1 required
integrationProfileEntity
object
1 property
rollbackDiscountEffectProps
object
The properties specific to the "rollbackDiscount" effect. This gets triggered whenever previously closed session is now cancelled or partially returned and a s…
7 properties 2 required
redeemReferralEffectProps
object
The properties specific to the "redeemReferral" effect. This gets triggered whenever the referral code is valid, and a rule was triggered that contains a "rede…
2 properties 2 required
userEntity
object
1 property 1 required
deductLoyaltyPointsEffectProps
object
The properties specific to the "deductLoyaltyPoints" effect. This gets triggered whenever a validated rule contained a condition to only trigger when the given…
7 properties 6 required
loyaltyProgramEntity
object
1 property 1 required
newReferral
triggerWebhookEffectProps
object
The properties specific to the "triggerWebhook" effect. This gets triggered whenever a validated rule contained a "trigger webhook" effect. This is communicate…
2 properties 2 required
referral
updateAttributeEffectProps
object
The properties specific to the "updateAttribute" effect. This gets triggered whenever a validated rule contained an "update an attribute" effect.
2 properties 2 required
rollbackCouponEffectProps
object
The properties specific to the "rollbackCoupon" effect. This gets triggered whenever previously closed session is now cancelled and a coupon redemption was can…
1 property 1 required
customEffectProps
object
Effect containing custom payload.
3 properties 3 required
rollbackAddedLoyaltyPointsEffectProps
object
The properties specific to the "rollbackAddedLoyaltyPoints" effect. This gets triggered whenever previously a closed session with an addLoyaltyPoints effect is…
8 properties 6 required
couponConstraints
object
4 properties
loyaltyCardProfileRegistration
object
2 properties 2 required
awardGiveawayEffectProps
object
The properties specific to the "awardGiveaway" effect. This effect contains information on the giveaway item, and which profile it was awarded to.
5 properties 5 required
meta
object
5 properties
acceptCouponEffectProps
object
The properties specific to the "acceptCoupon" effect. This gets triggered whenever the coupon is valid and all other conditions in the rules of its campaign ar…
1 property 1 required
customerSessionV2
CouponReservationRequest
object
3 properties 3 required
CouponReservationResponse
object
11 properties 6 required
campaignEntity
object
1 property 1 required
referralConstraints
object
3 properties 1 required
couponLimitConfigs
object
1 property
newCustomerSessionV2

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

talon-one-braze-api-openapi.yml Raw ↑

Other APIs Talon.One publishes across the network.

Talon.One Accounts and users API
Talon.One Achievements API
Talon.One Additional costs API
Talon.One Analytics API
Talon.One Applications API
Talon.One Attributes API
Talon.One Audiences API
Talon.One Campaign access groups API
Talon.One Campaign notifications API
Talon.One Campaign templates API
Talon.One Campaigns API
Talon.One Catalogs API
Where this information came from

This is an independent, third-party profile of Talon.One Braze API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.