# Gladly Freeform Topics API

**Canonical:** https://apis.io/apis/gladly/gladly-freeform-topics-api/  
**Provider:** Gladly — https://apis.io/providers/gladly/  
**Base URL:** https://organization.gladly.com/api/v1  
**Documentation:** https://developer.gladly.com/rest/

Gladly Freeform Topics API is one of 28 APIs that [Gladly](https://apis.io/providers/gladly/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 10 JSON Schema definitions. Tagged areas include Freeform Topics. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, authentication docs, a JSON-LD context, and 10 JSON Schemas.

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. Note: 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.

## Machine-readable artifacts (20)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/gladly/refs/heads/main/openapi/gladly-freeform-topics-api-openapi.yml
- **Documentation** — https://developer.gladly.com/rest/
- **APIReference** — https://developer.gladly.com/rest/
- **GettingStarted** — https://help.gladly.com/developer-tutorials/docs
- **Authentication** — https://developer.gladly.com/rest/
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gladly/refs/heads/main/json-schema/gladly-customer-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gladly/refs/heads/main/json-schema/gladly-conversation-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gladly/refs/heads/main/json-schema/gladly-task-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gladly/refs/heads/main/json-schema/gladly-answer-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gladly/refs/heads/main/json-schema/gladly-webhook-schema.json
- **JSONStructure** — https://raw.githubusercontent.com/api-evangelist/gladly/refs/heads/main/json-structure/gladly-customer-structure.json
- **JSONStructure** — https://raw.githubusercontent.com/api-evangelist/gladly/refs/heads/main/json-structure/gladly-conversation-structure.json
- **JSONStructure** — https://raw.githubusercontent.com/api-evangelist/gladly/refs/heads/main/json-structure/gladly-task-structure.json
- **JSONStructure** — https://raw.githubusercontent.com/api-evangelist/gladly/refs/heads/main/json-structure/gladly-answer-structure.json
- **JSONStructure** — https://raw.githubusercontent.com/api-evangelist/gladly/refs/heads/main/json-structure/gladly-webhook-structure.json
- **JSONLD** — https://raw.githubusercontent.com/api-evangelist/gladly/refs/heads/main/json-ld/gladly-context.jsonld
- **Examples** — https://raw.githubusercontent.com/api-evangelist/gladly/refs/heads/main/examples/gladly-customer-create-example.json
- **Examples** — https://raw.githubusercontent.com/api-evangelist/gladly/refs/heads/main/examples/gladly-conversation-list-example.json
- **Examples** — https://raw.githubusercontent.com/api-evangelist/gladly/refs/heads/main/examples/gladly-task-create-example.json
- **Examples** — https://raw.githubusercontent.com/api-evangelist/gladly/refs/heads/main/examples/gladly-webhook-create-example.json

## Other Gladly APIs (12)

- [Gladly Lookup API](https://apis.io/apis/gladly/gladly-lookup-api/)
- [Gladly Chat SDK](https://apis.io/apis/gladly/gladly-chat-sdk/)
- [Gladly Sidekick iOS SDK](https://apis.io/apis/gladly/gladly-sidekick-ios-sdk/)
- [Gladly Sidekick Android SDK](https://apis.io/apis/gladly/gladly-sidekick-android-sdk/)
- [Gladly Help Center](https://apis.io/apis/gladly/gladly-help-center/)
- [Gladly App Platform](https://apis.io/apis/gladly/gladly-app-platform/)
- [Gladly Webhooks](https://apis.io/apis/gladly/gladly-webhooks/)
- [Gladly Agents API](https://apis.io/apis/gladly/gladly-agents-api/)
- [Gladly Answer Management API](https://apis.io/apis/gladly/gladly-answer-management-api/)
- [Gladly Audiences API](https://apis.io/apis/gladly/gladly-audiences-api/)
- [Gladly Business Hours API](https://apis.io/apis/gladly/gladly-business-hours-api/)
- [Gladly Communications API](https://apis.io/apis/gladly/gladly-communications-api/)

## Tags

Freeform Topics

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/gladly/gladly-freeform-topics-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/gladly/.