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

Talkable Referrals API

The Referrals API from Talkable — 3 operation(s) for referrals.

Talkable Referrals API is one of 26 APIs that Talkable publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Referrals. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and authentication docs.

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

Requests are made against a single base URL, https://www.talkable.com.

3 operations 3 paths 2 schemas 2 GET1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
2.0
Base URL
https://www.talkable.com/api/v2
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Talkable Referrals API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (api_key). By default, every request must be authenticated.

  • api_key — Please provide here your API key, you can find it in Site Settings - API Integration - API Key

Paths & Operations 3

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

Referrals 3
GET
/api/v2/people/{person_slug}/referrals_as_advocate
Get Friends referred by Advocate
getFriendsReferredByAdvocate 2 params → 200400
GET
/api/v2/people/{person_slug}/referrals_as_friend
Get Advocates who referred the Friend
getAdvocatesWhoReferredFriend 2 params → 200400
PUT
/api/v2/origins/{origin_slug}/referral
Update referral status
updateReferralStatus 1 param body → 200400

Schemas 2

The contract defines 2 schemas that model the data the API accepts and returns. Each schema is shown below with its type and property counts.

person_slug
string
Person’s email, phone number, customer ID or username
origin_slug
string
If origin is a Purchase: ordernumber, e.g.: "B00K2EOONI" If origin is an Event: eventcategory:eventnumber, e.g.: "newslettersubscription:42"

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

talkable-referrals-api-openapi.yml Raw ↑

Other APIs Talkable publishes across the network.

Talkable Advocate Offers API
Talkable Advocate Signup API
Talkable Assets API
Talkable Campaigns API
Talkable Check Unsubscribe API
Talkable Claim Links API
Talkable Coupons API
Talkable Create Coupon API
Talkable Event API
Talkable Friend Email Gating API
Talkable Friend Offers API
Talkable Loyalty API