# Gladly Customers API

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

Gladly Customers 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 Customers. 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.

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.

## Machine-readable artifacts (20)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/gladly/refs/heads/main/openapi/gladly-customers-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

Customers

---

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