Gladly website screenshot

Gladly

Gladly is a San Francisco–based people-centered customer service AI platform. The Gladly Hero agent workspace unifies voice, chat, SMS, email, and social into a single, channel-agnostic conversation per Customer, while Gladly Sidekick AI handles routine resolutions, drafts replies, and hands off to humans with full context. Brands integrate via the REST API, the Chat SDK (Web/iOS/Android), the Help Center widget, the embedded App Platform, webhooks, and a brand-hosted Lookup API. Customers include JetBlue, Allbirds, Crate & Barrel, Warby Parker, Ulta, Nordstrom, TUMI, UGG, Tory Burch, and Breeze Airways.

Gladly publishes 21 APIs on the APIs.io network, including Agents API, Answer Management API, Audiences API, and 18 more. Tagged areas include Customer Service, CX, Contact Center, AI Customer Service, and Conversations.

The Gladly catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.

Gladly’s developer surface includes authentication, developer portal, documentation, API reference, support, getting-started guide, pricing, and 17 more developer resources.

56.8/100 strong ▼ -7.1 Agent 44/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreemiumSelf serve⚡ Free to try
28 APIs 10 Features 7 Use Cases
Customer ServiceCXContact CenterAI Customer ServiceConversationsSidekick AIHeroVoiceChatSMSEmailHelp CenterWebhooksKnowledge Base

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 56.8/100 · strong
Contract Quality 17.6 / 25
Developer Ergonomics 11.3 / 20
Commercial Clarity 14.2 / 20
Operational Transparency 3.4 / 13
Governance 8.3 / 12
Discoverability 5.9 / 10
Agent readiness — 44/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/gladly: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 28

Individual APIs this provider publishes, each with its own machine-readable definition.

Gladly Lookup API

Brand-hosted "Lookup" endpoint that Gladly calls outbound to enrich a conversation with first-party customer data. Lets brands keep system-of-record customer data in their own s...

Gladly Chat SDK

JavaScript chat widget loaded from the Gladly CDN. Exposes `Gladly.init`, `show`, `close`, `setUser`, `startConversation`, `navigate`, `applyCampaign`, `getAvailability`, plus a...

Gladly Sidekick iOS SDK

Swift SDK (v1.2.5, iOS 11+) for embedding the Gladly Sidekick chat experience in iOS apps. Ships `Gladly`, `GladlySettings`, `GladlyUser`, `UIConfiguration`, `UIHeaderConfigurat...

Gladly Sidekick Android SDK

Kotlin SDK (Android Q / API 29+) for embedding the Gladly Sidekick chat experience in Android apps. Provides `Gladly.initialize`, `setUser`, `showChat`, `handleMessageReceived`,...

Gladly Help Center

Embeddable Help Center widget that builds an FAQ/help page on a brand's website powered by Public Answers from Gladly's Answers knowledge base. Exposes a `.gladlyHC` CSS class h...

Gladly App Platform

Framework for building embedded "Apps" inside the Gladly Hero agent workspace. Apps surface third-party data (orders, loyalty, returns, CDP profiles) alongside the customer time...

Gladly Webhooks

Event-driven push channel that delivers Gladly platform events (conversation created/updated/closed, message created, task created/updated/closed, customer created/updated, agen...

Gladly Agents API

An **Agent** represents the user profile of a person who helps customers in Gladly. The API allows you to lookup Agents who participated in conversations with customers.

Gladly Answer Management API

The **Answer Management API** allows you to create, update, and delete Answers in Gladly. To create an Answer with content, two calls would be needed. One call to create an Answ...

Gladly Audiences API

An **Audience** represents a brand (or segment) specially for a multi-brand company. They are used to categorize Answers, Help Centers and Chats for the specific brands. The API...

Gladly Business Hours API

**Business Hours** define the operating schedule for your organization. They determine when your organization is available to handle customer communications and can be used to c...

Gladly Communications API

Communications API enables you to programmatically send messages to your customers. These messages are non-routable and non-searchable. ### Agent View ![Agent View](assets/agent...

Gladly Conversations API

## Conversation A **Conversation** in Gladly contains the timeline of activity for a customer including communications to and from your organization along with other internal an...

Gladly Customers API

A **Customer** in Gladly represents information about a customer of your organization including their profile, contact information, notes, and transactions. Customers API allows...

Gladly Events API

An **Event** is something that has happened in Gladly. The Events API allows you to extract event details from the past 24 hours.

Gladly Export API

Export API is a simple, comprehensive, file-based data export. You can export the lifetime of your customers' conversations in Gladly to a central data repository such as your d...

Gladly Freeform Topics API

Freeform Topics allow you to associate granular data like Order Number to a Conversation. This data can be accessed for analysis via APIs, Webhooks, and AWS EventBridge. They ar...

Gladly Inboxes API

An **Inbox** receives customer communications in Gladly. The communications route to the inbox according to channel and destination endpoint configuration. For example, all call...

Gladly Organization API

An **Organization** contains metadata about your company that Gladly is configured with.

Gladly Payloads API

The Payloads API from Gladly — 1 operation(s) for payloads.

Gladly Proactive Conversations API

A proactive conversation consists of a **campaign** and **recipients**. This APIs intended use-case would be to provide status updates to a customer and not for marketing purposes.

Gladly Public Answer API

A **Public Answer** in Gladly represents a consumer-facing Answer. The Public Answers API allows you to search and retrieve Public Answers (created directly in the Gladly UI), w...

Gladly Reports API

A **Report** in Gladly contains metrics that you need to run the contact center. Reports API allows you to access Gladly's reports programatically.

Gladly Tasks API

A task is a way to create and do internal follow-up work for a customer within Gladly. Tasks have a due date, an assignee, a description of what is needed for a customer, and ca...

Gladly Teams API

A **Team** represents a group of Agents. They may handle particular **Inboxes** or types of work within Gladly.

Gladly Topics API

A **Topic** is a way of labeling a conversation in Gladly for specific business purposes. For example, an agent may apply the topic "Return" to a conversation where a customer r...

Gladly User Identity API

The User Identity API from Gladly — 1 operation(s) for user identity.

Gladly Webhooks API

A **Webhook** is a way to send notifications about Gladly events as a POST request to the endpoint of your choice.

Scroll for all 28

Postman Collections 21

Ready-to-run Postman collections for exercising this provider's APIs.

Scroll for all 21

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Gladly API

OPEN COLLECTION

Pricing Plans 1

Published pricing tiers and plan structures.

Gladly Plans Pricing

7 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Gladly Rate Limits

2 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Features 10

Notable capabilities this provider offers.

Unified Customer Conversation

One channel-agnostic conversation per customer across voice, chat, SMS, email, and social — with full history visible to agents and Sidekick AI.

Gladly Sidekick AI

AI agent that resolves routine cases end-to-end, drafts agent replies, and hands off with full context. Configured in plain English via Guides.

Gladly Hero

People-centric agent workspace (formerly Gladly Team) with customer timeline, topics, tasks, and inbox routing.

Answers Knowledge Base

Versioned answers with audiences, topics, language scoping, and Help Center publication.

Lookup API Pattern

Brand-hosted endpoint Gladly calls to enrich conversations with first-party customer data — no need to mirror profiles into Gladly.

App Platform

Embedded apps inside Hero that surface third-party data (orders, loyalty, returns, CDP) next to the timeline.

Webhooks and Events

Push delivery of conversation, message, task, customer, and agent-state events to brand endpoints.

Bulk Export Jobs

Scheduled export jobs for agents, conversations, customers, and metrics in JSONL.

Multichannel Voice

Native voice channel with call recording, Voice AI deflection, and toll-free / local number support.

Help Center Widget

Embeddable, brand-styled self-service surface backed by Public Answers.

Scroll for all 10

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Gladly Context

0 classes · 5 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

Gladly API Rules

5 rules · 3 warnings 2 info

SPECTRAL

Gladly API Rules

4 rules · 1 errors 3 warnings

SPECTRAL

JSON Schema 5

Standalone JSON Schema definitions for this provider's data models.

Gladly Answer

10 properties

JSON SCHEMA

Gladly Conversation

10 properties

JSON SCHEMA

Gladly Customer

10 properties

JSON SCHEMA

Gladly Task

12 properties

JSON SCHEMA

Gladly Webhook

7 properties

JSON SCHEMA

JSON Structure 5

JSON Structure definitions describing this provider's data shapes.

Gladly Answer Structure

0 properties

JSON STRUCTURE

Gladly Conversation Structure

0 properties

JSON STRUCTURE

Gladly Customer Structure

0 properties

JSON STRUCTURE

Gladly Task Structure

0 properties

JSON STRUCTURE

Gladly Webhook Structure

0 properties

JSON STRUCTURE

Examples 4

Example request and response payloads for these APIs.

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Gladly Authentication

http · 1 scheme

SECURITY

Gladly Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Gladly Agentic Access

81 operations · 40 acting

81 operations · 40 acting

AGENTIC

Use Cases 7

What developers build with this provider.

Retail and DTC Customer Service

Tie order data from Shopify or BigCommerce to every conversation so agents can refund, replace, or cancel orders without leaving Hero.

Travel and Hospitality Care

Manage high-touch, multi-leg voice + messaging cases for airlines, cruise lines, and resorts (JetBlue, Breeze).

AI Deflection of Routine Cases

Have Sidekick AI fully resolve order-status, return, password-reset, and FAQ traffic with seamless human handoff.

Loyalty-Aware Service

Pull loyalty tier and lifetime value from Smile.io, Zinrelo, or LoyaltyLion to prioritize and personalize support.

Subscription Lifecycle Support

Coordinate billing, pause/skip, and renewal questions with Recharge, Recurly, Ordergroove, or Skio in-conversation.

CDP-Driven Personalization

Sync customer segments from Segment, HighTouch, or Fivetran into Gladly to tailor every interaction.

Proactive Outreach

Trigger outbound conversations from order events, delivery delays, or abandoned carts via Proactive Conversations and Communications APIs.

Scroll for all 7

Integrations 55

Pre-built integrations with other platforms and tools.

Shopify

Native bidirectional integration — order history, customer LTV, refunds, cancellations, and discount codes from inside the conversation.

BigCommerce

E-commerce platform integration for order and customer context.

Magento (Adobe Commerce)

E-commerce platform integration.

Klaviyo

Send conversation-created and closed events from Gladly to Klaviyo for segmentation and lifecycle email flows.

Recharge

Subscription management integration for pause/skip/cancel inside conversations.

Recurly

Subscription billing integration.

Ordergroove

Subscription and reorder integration.

Skio

Subscription management integration.

AfterShip

Shipment tracking and post-purchase notifications.

Loop

Returns management for e-commerce brands.

ReturnLogic

Returns and reverse-logistics integration.

Narvar

Post-purchase experience and tracking.

Corso

Shipping protection and order recovery.

Shiphero

Warehouse and order fulfillment.

Shipped Suite

Package protection and shipping confidence.

Segment (Source)

Stream Gladly events into Segment for the data warehouse and downstream tools.

Fivetran

ELT extraction of Gladly data into the data warehouse.

HighTouch

Reverse-ETL sync of warehouse audiences into Gladly customer profiles.

Smile.io

Loyalty program data surfaced in conversations.

LoyaltyLion

Loyalty program data and tier-aware routing.

Zinrelo

Loyalty program integration.

Attentive

SMS marketing audience and campaign integration.

Emplifi

Social media management integration.

Optimizely / Zaius

Customer data and personalization platform integration.

TurnTo

Reviews and Q&A integration.

ScreenMeet

In-conversation co-browse and screen-share.

Flip

Live-shopping and video customer support.

Facebook Messenger

Native social messaging channel.

AWS EventBridge

Stream Gladly events to AWS EventBridge for serverless downstream automation.

Linc

Voice-of-customer and AI assistance integration.

Ada Support

AI chatbot integration partner.

Netomi

AI customer experience platform integration.

Siena

Autonomous CX agent integration.

KODIF.ai

AI customer service automation integration.

AgentsOnly

On-demand agent staffing integration.

Endear

Clienteling and outreach for retail.

Simplr

On-demand customer service capacity.

HiOperator

Managed customer service operations partner.

Assembled

Workforce management for forecasting and scheduling.

MaestroQA

Quality assurance and agent scoring.

Playvox

Quality, coaching, and workforce optimization.

Calabrio

Workforce management and quality.

Medallia

Customer experience and feedback.

Medallia Agent Connect

Agent feedback and coaching loop.

Simplesat

CSAT survey integration.

Delighted

NPS and customer satisfaction surveys.

Qualtrics

Enterprise experience management surveys.

Hark

Voice-of-customer escalation video capture.

SentiSum

Tagging and analytics for conversations.

Formspree

Form-to-conversation routing.

Formstack

Form data routing into Gladly.

Jotform

Form ingestion into customer conversations.

Idiomatic

Conversation analytics and CX insights.

Spree Commerce

Open-source e-commerce platform integration.

Swell

Headless commerce integration.

Scroll for all 55

Solutions 5

Packaged solutions this provider offers.

Gladly Hero

People-centered agent workspace for voice, chat, SMS, email, and social — formerly known as Gladly Team.

Gladly Sidekick AI

AI customer service agent that resolves routine cases end-to-end and hands off to human agents with full context.

Gladly Voice AI

Voice-channel AI assistant priced per minute, layered on the native voice channel.

Gladly Help Center

Embedded self-service experience powered by Public Answers.

Gladly App Platform

Embedded apps and connectors inside the Hero workspace.

Resources

Get Started 2

Portal, sign-up, and the first successful call

Documentation 2

Reference material describing how the API behaves

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 3

Pagination, idempotency, versioning, errors, and events

Build 2

SDKs, sample code, and the tooling you integrate with

Access & Security 2

Authentication, authorization, and security posture

Learn 1

Tutorials, courses, talks, and written guidance

Operate 3

Status, limits, changes, and where to get help

Commercial 5

Pricing, plans, and the legal terms of use

Company 3

The organization behind the API

Other 1

Properties that don't map to a standard resource type

Source (apis.yml)

apis.yml Raw ↑
aid: gladly
url: https://raw.githubusercontent.com/api-evangelist/gladly/refs/heads/main/apis.yml
apis:
- aid: gladly:gladly-lookup-api
  name: Gladly Lookup API
  tags:
  - Customer Service
  - Customer Data
  - Webhooks
  - Integrations
  humanURL: https://developer.gladly.com/rest/
  properties:
  - url: https://developer.gladly.com/rest/
    type: Documentation
  - url: https://github.com/gladly/lookup-practice
    type: SampleSource
  description: Brand-hosted "Lookup" endpoint that Gladly calls outbound to enrich a conversation with first-party customer
    data. Lets brands keep system-of-record customer data in their own services while presenting a unified profile inside
    the Gladly Hero agent workspace and to Sidekick AI.
- aid: gladly:gladly-chat-sdk
  name: Gladly Chat SDK
  tags:
  - Customer Service
  - Chat
  - SDK
  - Web
  humanURL: https://developer.gladly.com/chat/
  properties:
  - url: https://developer.gladly.com/chat/
    type: Documentation
  - url: https://cdn.gladly.com/chat-sdk/widget.js
    type: SDKs
  description: JavaScript chat widget loaded from the Gladly CDN. Exposes `Gladly.init`, `show`, `close`, `setUser`, `startConversation`,
    `navigate`, `applyCampaign`, `getAvailability`, plus a full event system (availability, conversation lifecycle, messages,
    campaigns). Supports JWT-authenticated user identity issued by the User Identity REST endpoint.
- aid: gladly:gladly-sidekick-ios-sdk
  name: Gladly Sidekick iOS SDK
  tags:
  - Customer Service
  - Chat
  - SDK
  - iOS
  - Mobile
  humanURL: https://developer.gladly.com/ios-sdk/
  properties:
  - url: https://developer.gladly.com/ios-sdk/
    type: Documentation
  - url: https://github.com/gladly/sidekick-ios-sdk
    type: SourceCode
  - url: https://github.com/gladly/sidekick-ios-sdk
    type: SDKs
  description: Swift SDK (v1.2.5, iOS 11+) for embedding the Gladly Sidekick chat experience in iOS apps. Ships `Gladly`,
    `GladlySettings`, `GladlyUser`, `UIConfiguration`, `UIHeaderConfiguration`, and delegate protocols for chat display, notifications,
    and unread counts.
- aid: gladly:gladly-sidekick-android-sdk
  name: Gladly Sidekick Android SDK
  tags:
  - Customer Service
  - Chat
  - SDK
  - Android
  - Mobile
  humanURL: https://developer.gladly.com/android-sdk/
  properties:
  - url: https://developer.gladly.com/android-sdk/
    type: Documentation
  - url: https://github.com/gladly/sidekick-android-sdk
    type: SourceCode
  - url: https://github.com/gladly/sidekick-android-sdk
    type: SDKs
  description: Kotlin SDK (Android Q / API 29+) for embedding the Gladly Sidekick chat experience in Android apps. Provides
    `Gladly.initialize`, `setUser`, `showChat`, `handleMessageReceived`, `getUnreadCount`, `registerPushToken`/`unregisterPushToken`
    plus EventInterface for events and errors.
- aid: gladly:gladly-help-center
  name: Gladly Help Center
  tags:
  - Customer Service
  - Help Center
  - Self-Service
  - Web
  humanURL: https://developer.gladly.com/help-center/
  properties:
  - url: https://developer.gladly.com/help-center/
    type: Documentation
  description: Embeddable Help Center widget that builds an FAQ/help page on a brand's website powered by Public Answers from
    Gladly's Answers knowledge base. Exposes a `.gladlyHC` CSS class hierarchy for fully custom styling. SPA support is limited
    (Next.js not supported); best run from a single non-SPA HTML page.
- aid: gladly:gladly-app-platform
  name: Gladly App Platform
  tags:
  - Customer Service
  - Apps
  - Integrations
  - Embedded
  humanURL: https://help.gladly.com/developer-tutorials/docs
  properties:
  - url: https://help.gladly.com/developer-tutorials/docs
    type: Documentation
  - url: https://github.com/gladly/app-platform-examples
    type: SampleSource
  - url: https://github.com/gladly/app-platform-appcfg-cli
    type: CLI
  - url: https://github.com/gladly/gladly-getting-started
    type: SampleSource
  - url: https://github.com/gladly/gladapp-examples
    type: SampleSource
  description: Framework for building embedded "Apps" inside the Gladly Hero agent workspace. Apps surface third-party data
    (orders, loyalty, returns, CDP profiles) alongside the customer timeline. Authored as JavaScript/Groovy bundles and managed
    via the `app-platform-appcfg-cli`.
- aid: gladly:gladly-webhooks
  name: Gladly Webhooks
  tags:
  - Customer Service
  - Webhooks
  - Events
  humanURL: https://developer.gladly.com/rest/
  properties:
  - url: https://developer.gladly.com/rest/
    type: Documentation
  - url: https://github.com/gladly/webhook-examples
    type: SampleSource
  - url: json-schema/gladly-webhook-schema.json
    type: JSONSchema
  - url: examples/gladly-webhook-create-example.json
    type: Examples
  description: Event-driven push channel that delivers Gladly platform events (conversation created/updated/closed, message
    created, task created/updated/closed, customer created/updated, agent state changes) to a brand-supplied HTTPS endpoint.
    Managed through the Webhooks REST endpoints. Includes retry policy and logging.
- aid: gladly:gladly-agents-api
  name: Gladly Agents API
  description: 'An **Agent** represents the user profile of a person who helps customers in Gladly.

    The API allows you to lookup Agents who participated in conversations with customers.'
  humanURL: https://developer.gladly.com/rest/
  baseURL: https://organization.gladly.com/api/v1
  tags:
  - Agents
  properties:
  - type: OpenAPI
    url: openapi/gladly-agents-api-openapi.yml
  - type: Documentation
    url: https://developer.gladly.com/rest/
  - type: APIReference
    url: https://developer.gladly.com/rest/
  - type: GettingStarted
    url: https://help.gladly.com/developer-tutorials/docs
  - type: Authentication
    url: https://developer.gladly.com/rest/
  - type: JSONSchema
    url: json-schema/gladly-customer-schema.json
  - type: JSONSchema
    url: json-schema/gladly-conversation-schema.json
  - type: JSONSchema
    url: json-schema/gladly-task-schema.json
  - type: JSONSchema
    url: json-schema/gladly-answer-schema.json
  - type: JSONSchema
    url: json-schema/gladly-webhook-schema.json
  - type: JSONStructure
    url: json-structure/gladly-customer-structure.json
  - type: JSONStructure
    url: json-structure/gladly-conversation-structure.json
  - type: JSONStructure
    url: json-structure/gladly-task-structure.json
  - type: JSONStructure
    url: json-structure/gladly-answer-structure.json
  - type: JSONStructure
    url: json-structure/gladly-webhook-structure.json
  - type: JSONLD
    url: json-ld/gladly-context.jsonld
  - type: Examples
    url: examples/gladly-customer-create-example.json
  - type: Examples
    url: examples/gladly-conversation-list-example.json
  - type: Examples
    url: examples/gladly-task-create-example.json
  - type: Examples
    url: examples/gladly-webhook-create-example.json
- aid: gladly:gladly-answer-management-api
  name: Gladly Answer Management API
  description: "The **Answer Management API** allows you to create, update, and delete Answers in Gladly. To create an Answer\
    \ with content, two calls would be needed. \nOne call to create an Answer and subsequent call(s) to add content(s)"
  humanURL: https://developer.gladly.com/rest/
  baseURL: https://organization.gladly.com/api/v1
  tags:
  - Answer Management
  properties:
  - type: OpenAPI
    url: openapi/gladly-answer-management-api-openapi.yml
  - type: Documentation
    url: https://developer.gladly.com/rest/
  - type: APIReference
    url: https://developer.gladly.com/rest/
  - type: GettingStarted
    url: https://help.gladly.com/developer-tutorials/docs
  - type: Authentication
    url: https://developer.gladly.com/rest/
  - type: JSONSchema
    url: json-schema/gladly-customer-schema.json
  - type: JSONSchema
    url: json-schema/gladly-conversation-schema.json
  - type: JSONSchema
    url: json-schema/gladly-task-schema.json
  - type: JSONSchema
    url: json-schema/gladly-answer-schema.json
  - type: JSONSchema
    url: json-schema/gladly-webhook-schema.json
  - type: JSONStructure
    url: json-structure/gladly-customer-structure.json
  - type: JSONStructure
    url: json-structure/gladly-conversation-structure.json
  - type: JSONStructure
    url: json-structure/gladly-task-structure.json
  - type: JSONStructure
    url: json-structure/gladly-answer-structure.json
  - type: JSONStructure
    url: json-structure/gladly-webhook-structure.json
  - type: JSONLD
    url: json-ld/gladly-context.jsonld
  - type: Examples
    url: examples/gladly-customer-create-example.json
  - type: Examples
    url: examples/gladly-conversation-list-example.json
  - type: Examples
    url: examples/gladly-task-create-example.json
  - type: Examples
    url: examples/gladly-webhook-create-example.json
- aid: gladly:gladly-audiences-api
  name: Gladly Audiences API
  description: 'An **Audience** represents a brand (or segment) specially for a multi-brand company. They are used to categorize
    Answers, Help Centers and Chats for the specific brands.

    The API allows you to lookup the audiences that have been created for the organization.'
  humanURL: https://developer.gladly.com/rest/
  baseURL: https://organization.gladly.com/api/v1
  tags:
  - Audiences
  properties:
  - type: OpenAPI
    url: openapi/gladly-audiences-api-openapi.yml
  - type: Documentation
    url: https://developer.gladly.com/rest/
  - type: APIReference
    url: https://developer.gladly.com/rest/
  - type: GettingStarted
    url: https://help.gladly.com/developer-tutorials/docs
  - type: Authentication
    url: https://developer.gladly.com/rest/
  - type: JSONSchema
    url: json-schema/gladly-customer-schema.json
  - type: JSONSchema
    url: json-schema/gladly-conversation-schema.json
  - type: JSONSchema
    url: json-schema/gladly-task-schema.json
  - type: JSONSchema
    url: json-schema/gladly-answer-schema.json
  - type: JSONSchema
    url: json-schema/gladly-webhook-schema.json
  - type: JSONStructure
    url: json-structure/gladly-customer-structure.json
  - type: JSONStructure
    url: json-structure/gladly-conversation-structure.json
  - type: JSONStructure
    url: json-structure/gladly-task-structure.json
  - type: JSONStructure
    url: json-structure/gladly-answer-structure.json
  - type: JSONStructure
    url: json-structure/gladly-webhook-structure.json
  - type: JSONLD
    url: json-ld/gladly-context.jsonld
  - type: Examples
    url: examples/gladly-customer-create-example.json
  - type: Examples
    url: examples/gladly-conversation-list-example.json
  - type: Examples
    url: examples/gladly-task-create-example.json
  - type: Examples
    url: examples/gladly-webhook-create-example.json
- aid: gladly:gladly-business-hours-api
  name: Gladly Business Hours API
  description: '**Business Hours** define the operating schedule for your organization. They determine when your organization
    is available to handle customer communications and can be used to control routing, auto-responses, and other time-sensitive
    workflows.


    Business hours configurations include:

    - **Schedule blocks** for each day of the week specifying start and end times

    - **Timezone** in IANA format (e.g., America/Los_Angeles)

    - **Exceptions** for holidays or special dates


    One business hours configuration is marked as **primary** and serves as the default schedule for your organization. The
    primary business hours cannot be deleted.'
  humanURL: https://developer.gladly.com/rest/
  baseURL: https://organization.gladly.com/api/v1
  tags:
  - Business Hours
  properties:
  - type: OpenAPI
    url: openapi/gladly-business-hours-api-openapi.yml
  - type: Documentation
    url: https://developer.gladly.com/rest/
  - type: APIReference
    url: https://developer.gladly.com/rest/
  - type: GettingStarted
    url: https://help.gladly.com/developer-tutorials/docs
  - type: Authentication
    url: https://developer.gladly.com/rest/
  - type: JSONSchema
    url: json-schema/gladly-customer-schema.json
  - type: JSONSchema
    url: json-schema/gladly-conversation-schema.json
  - type: JSONSchema
    url: json-schema/gladly-task-schema.json
  - type: JSONSchema
    url: json-schema/gladly-answer-schema.json
  - type: JSONSchema
    url: json-schema/gladly-webhook-schema.json
  - type: JSONStructure
    url: json-structure/gladly-customer-structure.json
  - type: JSONStructure
    url: json-structure/gladly-conversation-structure.json
  - type: JSONStructure
    url: json-structure/gladly-task-structure.json
  - type: JSONStructure
    url: json-structure/gladly-answer-structure.json
  - type: JSONStructure
    url: json-structure/gladly-webhook-structure.json
  - type: JSONLD
    url: json-ld/gladly-context.jsonld
  - type: Examples
    url: examples/gladly-customer-create-example.json
  - type: Examples
    url: examples/gladly-conversation-list-example.json
  - type: Examples
    url: examples/gladly-task-create-example.json
  - type: Examples
    url: examples/gladly-webhook-create-example.json
- aid: gladly:gladly-communications-api
  name: Gladly Communications API
  description: 'Communications API enables you to programmatically send messages to your customers. These messages are non-routable
    and non-searchable.


    ### Agent View

    ![Agent View](assets/agent-sms.png)


    ### Consumer View

    ![Customer View](assets/consumer-sms.png)'
  humanURL: https://developer.gladly.com/rest/
  baseURL: https://organization.gladly.com/api/v1
  tags:
  - Communications
  properties:
  - type: OpenAPI
    url: openapi/gladly-communications-api-openapi.yml
  - type: Documentation
    url: https://developer.gladly.com/rest/
  - type: APIReference
    url: https://developer.gladly.com/rest/
  - type: GettingStarted
    url: https://help.gladly.com/developer-tutorials/docs
  - type: Authentication
    url: https://developer.gladly.com/rest/
  - type: JSONSchema
    url: json-schema/gladly-customer-schema.json
  - type: JSONSchema
    url: json-schema/gladly-conversation-schema.json
  - type: JSONSchema
    url: json-schema/gladly-task-schema.json
  - type: JSONSchema
    url: json-schema/gladly-answer-schema.json
  - type: JSONSchema
    url: json-schema/gladly-webhook-schema.json
  - type: JSONStructure
    url: json-structure/gladly-customer-structure.json
  - type: JSONStructure
    url: json-structure/gladly-conversation-structure.json
  - type: JSONStructure
    url: json-structure/gladly-task-structure.json
  - type: JSONStructure
    url: json-structure/gladly-answer-structure.json
  - type: JSONStructure
    url: json-structure/gladly-webhook-structure.json
  - type: JSONLD
    url: json-ld/gladly-context.jsonld
  - type: Examples
    url: examples/gladly-customer-create-example.json
  - type: Examples
    url: examples/gladly-conversation-list-example.json
  - type: Examples
    url: examples/gladly-task-create-example.json
  - type: Examples
    url: examples/gladly-webhook-create-example.json
- aid: gladly:gladly-conversations-api
  name: Gladly Conversations API
  description: '## Conversation


    A **Conversation** in Gladly contains the timeline of activity for a customer including communications to and from your
    organization along with other internal and external activity.

    Conversations API enables you to interact with the customer conversation timeline.


    ## Conversation Items


    A number of different types of items may appear in a customer''s timeline. Each is described below.


    | Item Type                     | Item Definition | Create | Read | Update | Delete | Media  |

    |-------------------------------|----------------|--------|------|--------|--------|--------|

    | Chat Message                  | A message sent/received via the [Chat](https://help.gladly.com/docs/add-and-configure-chat-entry-points#)
    channel | Yes    | Yes  | No     | No     | No     |

    | Conversation Status Change    | Conversation status changed (e.g.: from OPEN to WAITING, or OPEN to CLOSED) | Yes    |
    Yes  | Yes    | No     | No     |

    | Customer Activity             | Non-routable customer activity added to customer timeline via API | Yes    | Yes  |
    No     | Yes    | No     |

    | Email                         | A message sent/received via the [Email](https://help.gladly.com/docs/add-and-configure-email-entry-point)
    channel | Yes    | Yes  | No     | No     | No     |

    | Facebook Messenger Message    | A message sent/received via the [Facebook Messenger](https://help.gladly.com/docs/set-up-and-configure-facebook-messenger)
    channel | Yes    | Yes  | No     | No     | No     |

    | Instagram Direct              | A message sent/received via the [Instagram](https://help.gladly.com/docs/set-up-and-configure-instagram-messaging)
    channel | No     | Yes  | No     | No     | No     |

    | Note                          | An internal [Note](https://help.gladly.com/docs/add-a-note-to-a-conversation) on the
    Customer conversation | Yes    | Yes  | No     | No     | No     |

    | Phone Call                    | A [Phone Call](https://help.gladly.com/docs/add-and-configure-voice-entry-points) placed/received
    on Gladly | No     | Yes  | No     | No     | Yes    |

    | SMS Message                   | A message sent/received via the [SMS](https://help.gladly.com/docs/add-and-configure-sms-entry-points)
    channel | Yes    | Yes  | No     | No     | No     |

    | Task                          | A [Task](https://help.gladly.com/docs/what-is-a-task) on a Customer''s profile | Yes    |
    Yes  | Yes    | No     | No     |

    | Topic Change                  | A [Topic](https://help.gladly.com/docs/what-are-topics) added or removed on a Conversation
    | Yes    | Yes  | No     | Yes    | No     |

    | Twitter (decommissioned as of 04/20/23)                       | A message sent/received via the [Twitter](https://help.gladly.com/docs/setup-and-configure-twitter-direct-messages)
    channel | No     | Yes  | No     | Yes    | No     |

    | Voice AI Message              | A spoken message exchanged with Gladly''s voice AI during a voice AI session | No     |
    Yes  | No     | No     | No     |

    | Voicemail                     | A Voicemail received | No     | Yes  | No     | No     | Yes    |

    | WhatsApp                      | A message sent/received via the WhatsApp channel | No     | Yes  | No     | No     |
    No     |



    ### Chat Message


    Content of messages sent between Gladly and customers through Gladly Chat.


    ### Conversation Status Change


    Record of a change in the status of a conversation.


    ### Customer Activity


    Information about activities customers participated in, for example, emails they received, issues in another system, or
    customer satisfaction surveys they answered.

    These can be created through the API to bring in information from other systems.

    Adding an activity to the customer timeline is not customer facing.

    For example, posting an email activity to the timeline does not send an email to the customer.

    ![Customer Activity](assets/customer-activity.png)


    ### Email


    Content of emails sent between Gladly and customers.


    ###  Facebook Messenger Message


    Content of messages sent between Gladly and customers on Facebook Messenger.


    ### Instagram Direct


    Content of messages sent between Gladly and customers on Instagram Direct.


    ###  Note


    Content of the note recorded in Gladly.


    ### Phone Call


    Information about phone calls that took place between Gladly and customers.


    ### SMS Message


    Content of SMS text messages sent between Gladly and customers.

    To send SMS messages to customers through the API, see [Send SMS](#operation/sendSMS).


    ### Task


    Interacting with tasks through the conversations API is deprecated. Use [Tasks API](#tag/Tasks) instead.


    ### Topic Change


    Record of an agent adding or removing a topic from a conversation in Gladly.


    ### Twitter (decommissioned as of 04/20/23)


    Content of messages sent between Gladly and customers on Twitter.


    ### Voice AI Message


    A spoken message exchanged between a customer and Gladly''s voice AI during a voice AI session.


    ### Voicemail


    Information about voicemail left by customers in Gladly.


    ### WhatsApp


    Content of messages sent between Gladly and customers on WhatsApp.'
  humanURL: https://developer.gladly.com/rest/
  baseURL: https://organization.gladly.com/api/v1
  tags:
  - Conversations
  properties:
  - type: OpenAPI
    url: openapi/gladly-conversations-api-openapi.yml
  - type: Documentation
    url: https://developer.gladly.com/rest/
  - type: APIReference
    url: https://developer.gladly.com/rest/
  - type: GettingStarted
    url: https://help.gladly.com/developer-tutorials/docs
  - type: Authentication
    url: https://developer.gladly.com/rest/
  - type: JSONSchema
    url: json-schema/gladly-customer-schema.json
  - type: JSONSchema
    url: json-schema/gladly-conversation-schema.json
  - type: JSONSchema
    url: json-schema/gladly-task-schema.json
  - type: JSONSchema
    url: json-schema/gladly-answer-schema.json
  - type: JSONSchema
    url: json-schema/gladly-webhook-schema.json
  - type: JSONStructure
    url: json-structure/gladly-customer-structure.json
  - type: JSONStructure
    url: json-structure/gladly-conversation-structure.json
  - type: JSONStructure
    url: json-structure/gladly-task-structure.json
  - type: JSONStructure
    url: json-structure/gladly-answer-structure.json
  - type: JSONStructure
    url: json-structure/gladly-webhook-structure.json
  - type: JSONLD
    url: json-ld/gladly-context.jsonld
  - type: Examples
    url: examples/gladly-customer-create-example.json
  - type: Examples
    url: examples/gladly-conversation-list-example.json
  - type: Examples
    url: examples/gladly-task-create-example.json
  - type: Examples
    url: examples/gladly-webhook-create-example.json
- aid: gladly:gladly-customers-api
  name: Gladly Customers API
  description: 'A **Customer** in Gladly represents information about a customer of your organization including their profile,
    contact information,

    notes, and transactions.


    Customers API allows you to add, update, and get customer profile data.


    ### Error Handling

    Id, mobile phone number, and email address must be unique across customer records. 409 errors returned will

    include details on any conflicts, such as a field being taken.


    Additionally, errors may be returned due to customer profiles being merged. If a customer has been merged into

    another, requests to get a customer by id will return 301 errors specifying the new id of the customer,

    and requests to update a customer by id will return 404 errors.'
  humanURL: https://developer.gladly.com/rest/
  baseURL: https://organization.gladly.com/api/v1
  tags:
  - Customers
  properties:
  - type: OpenAPI
    url: openapi/gladly-customers-api-openapi.yml
  - type: Documentation
    url: https://developer.gladly.com/rest/
  - type: APIReference
    url: https://developer.gladly.com/rest/
  - type: GettingStarted
    url: https://help.gladly.com/developer-tutorials/docs
  - type: Authentication
    url: https://developer.gladly.com/rest/
  - type: JSONSchema
    url: json-schema/gladly-customer-schema.json
  - type: JSONSchema
    url: json-schema/gladly-conversation-schema.json
  - type: JSONSchema
    url: json-schema/gladly-task-schema.json
  - type: JSONSchema
    url: json-schema/gladly-answer-schema.json
  - type: JSONSchema
    url: json-schema/gladly-webhook-schema.json
  - type: JSONStructure
    url: json-structure/gladly-customer-structure.json
  - type: JSONStructure
    url: json-structure/gladly-conversation-structure.json
  - type: JSONStructure
    url: json-structure/gladly-task-structure.json
  - type: JSONStructure
    url: json-structure/gladly-answer-structure.json
  - type: JSONStructure
    url: json-structure/gladly-webhook-structure.json
  - type: JSONLD
    url: json-ld/gladly-context.jsonld
  - type: Examples
    url: examples/gladly-customer-create-example.json
  - type: Examples
    url: examples/gladly-conversation-list-example.json
  - type: Examples
    url: examples/gladly-task-create-example.json
  - type: Examples
    url: examples/gladly-webhook-create-example.json
- aid: gladly:gladly-events-api
  name: Gladly Events API
  description: An **Event** is something that has happened in Gladly. The Events API allows you to extract event details from
    the past 24 hours.
  humanURL: https://developer.gladly.com/rest/
  baseURL: https://organization.gladly.com/api/v1
  tags:
  - Events
  properties:
  - type: OpenAPI
    url: openapi/gladly-events-api-openapi.yml
  - type: Documentation
    url: https://developer.gladly.com/rest/
  - type: APIReference
    url: https://developer.gladly.com/rest/
  - type: GettingStarted
    url: https://help.gladly.com/developer-tutorials/docs
  - type: Authentication
    url: https://developer.gladly.com/rest/
  - type: JSONSchema
    url: json-schema/gladly-customer-schema.json
  - type: JSONSchema
    url: json-schema/gladly-conversation-schema.json
  - type: JSONSchema
    url: json-schema/gladly-task-schema.json
  - type: JSONSchema
    url: json-schema/gladly-answer-schema.json
  - type: JSONSchema
    url: json-schema/gladly-webhook-schema.json
  - type: JSONStructure
    url: json-structure/gladly-customer-structure.json
  - type: JSONStructure
    url: json-structure/gladly-conversation-structure.json
  - type: JSONStructure
    url: json-structure/gladly-task-structure.json
  - type: JSONStructure
    url: json-structure/gladly-answer-structure.json
  - type: JSONStructure
    url: json-structure/gladly-webhook-structure.json
  - type: JSONLD
    url: json-ld/gladly-context.jsonld
  - type: Examples
    url: examples/gladly-customer-create-example.json
  - type: Examples
    url: examples/gladly-conversation-list-example.json
  - type: Examples
    url: examples/gladly-task-create-example.json
  - type: Examples
    url: examples/gladly-webhook-create-example.json
- aid: gladly:gladly-export-api
  name: Gladly Export API
  description: 'Export API is a simple, comprehensive, file-based data export. You can export the lifetime of your customers''
    conversations in Gladly to a central data repository such as your data warehouse or data lake. You can export all communications
    successfully delivered within a specified date range.  The export date range could be the past hour, the past 24 hours,
    or a custom data range. Please note, for one-time exports covering a period greater than six months, a service fee may
    apply.


    Job results can be deleted once downloaded.  Delete will remove all result files along with the job metadata.  Files older
    than 14 days are removed from Gladly and jobs older than 14 days are not available from the API.  If you discover that
    you need the deleted files later, please contact Gladly Support to regenerate them for you.


    ### SCHEDULING EXPORT JOBS


    You can schedule a one-time or repeating - hourly or daily - data export job.  By default, each organization has a daily
    export job configured.  To schedule a one-time job or change the job frequency, please contact Gladly Support.'
  humanURL: https://developer.gladly.com/rest/
  baseURL: https://organization.gladly.com/api/v1
  tags:
  - Export
  properties:
  - type: OpenAPI
    url: openapi/gladly-export-api-openapi.yml
  - type: Documentation
    url: https://developer.gladly.com/rest/
  - type: APIReference
    url: https://developer.gladly.com/rest/
  - type: GettingStarted
    url: https://help.gladly.com/developer-tutorials/docs
  - type: Authentication
    url: https://developer.gladly.com/rest/
  - type: JSONSchema
    url: json-schema/gladly-customer-schema.json
  - type: JSONSchema
    url: json-schema/gladly-conversation-schema.json
  - type: JSONSchema
    url: json-schema/gladly-task-schema.json
  - type: JSONSchema
    url: json-schema/gladly-answer-schema.json
  - type: JSONSchema
    url: json-schema/gladly-webhook-schema.json
  - type: JSONStructure
    url: json-structure/gladly-customer-structure.json
  - type: JSONStructure
    url: json-structure/gladly-conversation-structure.json
  - type: JSONStructure
    url: json-structure/gladly-task-structure.json
  - type: JSONStructure
    url: json-structure/gladly-answer-structure.json
  - type: JSONStructure
    url: json-structure/gladly-webhook-structure.json
  - type: JSONLD
    url: json-ld/gladly-context.jsonld
  - type: Examples
    url: examples/gladly-customer-create-example.json
  - type: Examples
    url: examples/gladly-conversation-list-example.json
  - type: Examples
    url: examples/gladly-task-create-example.json
  - type: Examples
    url: examples/gladly-webhook-create-example.json
- aid: gladly:gladly-freeform-topics-api
  name: Gladly Freeform Topics API
  description: "Freeform Topics allow you to associate granular data like Order Number to a Conversation. This data can be\
    \ accessed for analysis via APIs, Webhooks, and AWS EventBridge. They are powered by custom attributes as you will see\
    \ throughout this API, the Conversations API, the Events API and events used in Webhooks. \n\nNote: These attributes are\
    \ currently associated to the Conversation entity only and are therefore different from customAttributes listed under\
    \ the Customer entity. See the Customer API for more information on Customer custom attributes."
  humanURL: https://developer.gladly.com/rest/
  baseURL: https://organization.gladly.com/api/v1
  tags:
  - Freeform Topics
  properties:
  - type: OpenAPI
    url: openapi/gladly-freeform-topics-api-openapi.yml
  - type: Documentation
    url: https://developer.gladly.com/rest/
  - type: APIReference
    url: https://developer.gladly.com/rest/
  - type: GettingStarted
    url: https://help.gladly.com/developer-tutorials/docs
  - type: Authentication
    url: https://developer.gladly.com/rest/
  - type: JSONSchema
    url: json-schema/gladly-customer-schema.json
  - type: JSONSchema
    url: json-schema/gladly-conversation-schema.json
  - type: JSONSchema
    url: json-schema/gladly-task-schema.json
  - type: JSONSchema
    url: json-schema/gladly-answer-schema.json
  - type: JSONSchema
    url: json-schema/gladly-webhook-schema.json
  - type: JSONStructure
    url: json-structure/gladly-customer-structure.json
  - type: JSONStructure
    url: json-structure/gladly-conversation-structure.json
  - type: JSONStructure
    url: json-structure/gladly-task-structure.json
  - type: JSONStructure
    url: json-structure/gladly-answer-structure.json
  - type: JSONStructure
    url: json-structure/gladly-webhook-structure.json
  - type: JSONLD
    url: json-ld/gladly-context.jsonld
  - type: Examples
    url: examples/gladly-customer-create-example.json
  - type: Examples
    url: examples/gladly-conversation-list-example.json
  - type: Examples
    url: examples/gladly-task-create-example.json
  - type: Examples
    url: examples/gladly-webhook-create-example.json
- aid: gladly:gladly-inboxes-api
  name: Gladly Inboxes API
  description: 'An **Inbox** receives customer communications in Gladly. The communications route to the inbox according to
    channel and destination endpoint configuration.

    For example, all calls to a specific phone number or emails to a specific address may go to an inbox.'
  humanURL: https://developer.gladly.com/rest/
  baseURL: https://organization.gladly.com/api/v1
  tags:
  - Inboxes
  properties:
  - type: OpenAPI
    url: openapi/gladly-inboxes-api-openapi.yml
  - type: Documentation
    url: https://developer.gladly.com/rest/
  - type: APIReference
    url: https://developer.gladly.com/rest/
  - type: GettingStarted
    url: https://help.gladly.com/developer-tutorials/docs
  - type: Authentication
    url: https://developer.gladly.com/rest/
  - type: JSONSchema
    url: json-schema/gladly-customer-schema.json
  - type: JSONSchema
    url: json-schema/gladly-conversation-schema.json
  - type: JSONSchema
    url: json-schema/gladly-task-schema.json
  - type: JSONSchema
    url: json-schema/gladly-answer-schema.json
  - type: JSONSchema
    url: json-schema/gladly-webhook-schema.json
  - type: JSONStructure
    url: json-structure/gladly-customer-structure.json
  - type: JSONStructure
    url: json-structure/gladly-conversation-structure.json
  - type: JSONStructure
    url: json-structure/gladly-task-structure.json
  - type: JSONStructure
    url: json-stru

# --- truncated at 32 KB (62 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/gladly/refs/heads/main/apis.yml