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
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Talon.One

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).

Documentation Provider Profile APIs.io OpenAPI GitHub

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](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 automat…

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), cartItem (14 properties), IntegrationStateV2 (14 properties), BrazeCouponResponse (13 properties). Each schema is shown below with its type and property counts.

limitConfig
object
4 properties 3 required
newCampaign
object
13 properties 5 required
effectProps
object
referral
customerProfile
BrazeCouponRequest
object
15 properties 4 required
inventoryReferral
additionalCost
object
1 property
id
integer
Unique ID for this entity.
loyalty
object
Customer specific information about loyalty points.
2 properties 1 required
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
loyaltyProgramEntity
object
1 property 1 required
customerProfileID
string
The integration ID of the customer profile. If the customer profile does not exist, it will be created.
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
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
CouponReservationRequest
object
3 properties 3 required
importEntity
object
1 property 1 required
meta
object
5 properties
customerSessionV2
customEffectProps
object
Effect containing custom payload.
3 properties 3 required
updateLoyaltyCard
object
1 property 1 required
referralConstraints
object
3 properties 1 required
entityWithTalangVisibleID
object
2 properties 2 required
BrazeTrackEventRequest
campaignEntity
object
1 property 1 required
applicationEntity
object
1 property 1 required
loyaltyCardProfileRegistration
object
2 properties 2 required
TrackEventRequest
object
4 properties 3 required
couponLimitConfigs
object
1 property
CouponReservationResponse
object
11 properties 6 required
ReferralRequest
object
8 properties 3 required
coupon
entity
object
2 properties 2 required
userEntity
object
1 property 1 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…
ReferralResponse
object
12 properties
newReferral
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
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
newCustomerSessionV2
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
return
returnedCartItem
object
2 properties 1 required
BrazeCouponResponse
object
13 properties
newReturn
object
1 property 1 required
loyaltyCard
accountEntity
object
1 property 1 required
ledgerEntry
effect
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
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
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
giveaway
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
ledgerInfo
object
7 properties
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
integrationProfileEntity
object
1 property
loyaltyProgramLedgers
object
Customer specific information about loyalty points.
5 properties 4 required
codeGeneratorSettings
object
2 properties 2 required
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
cartItem
object
14 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
integrationEntity
object
2 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
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
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
event
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
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
errorResponseWithStatus
object
3 properties
integrationEvent
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
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
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
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
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
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
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
ruleFailureReason
object
Details about why a rule failed.
12 properties 5 required
couponValue
object
1 property
effectEntity
object
Definition of all properties that are present on all effects, independent of their type.
6 properties 5 required
couponConstraints
object
4 properties
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
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…
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
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
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
campaign

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
AE Profile APIs.io
Talon.One Achievements API
AE Profile APIs.io
Talon.One Additional costs API
AE Profile APIs.io
Talon.One Analytics API
AE Profile APIs.io
Talon.One Applications API
AE Profile APIs.io
Talon.One Attributes API
AE Profile APIs.io
Talon.One Audiences API
AE Profile APIs.io
Talon.One Campaign access groups API
AE Profile APIs.io
Talon.One Campaign notifications API
AE Profile APIs.io
Talon.One Campaign templates API
AE Profile APIs.io
Talon.One Campaigns API
AE Profile APIs.io
Talon.One Catalogs API
AE Profile APIs.io
#Braze
← Back to T APIs
API Details
ID
talon-one:talon-one-braze-api
Base URL
https://yourbaseurl.talon.one
Docs
https://docs.talon.one/docs/dev/integration-api/overview
Provider
Talon.One
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=talon-one-braze-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/talon-one-braze-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

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

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.