GorillaDesk Customers API
The Customers API from GorillaDesk — 1 operation(s) for customers.
The Customers API from GorillaDesk — 1 operation(s) for customers.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/gorilladesk:gorilladesk-customers-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: GorillaDesk Customers API
version: 1.0.0
description: '# Introduction
The GorillaDesk API is organized around REST.
Our API has predictable resource-oriented URLs, accepts JSON-encoded and form-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs..
# Authentication
The GorillaDesk API uses Token authentication. API keys are per-company and can be generated and deleted in the Addons page.
# Rate Limits
We enforce API call rate limits to protect our infrastructure from excessive request rates, to keep GorillaDesk fast and stable for everyone. These limits are high enough that typical API workflows aren''t affected. However, please do code your integration to follow the rule below:
**If you receive a response status code of 429 (Too Many Requests), please sleep/pause for the number of seconds specified by the rate_reset value before making additional requests to that endpoint.**
Rate limits are enforced per endpoint group. Endpoint groups are used to provide more granular control by grouping endpoint URL paths and methods (e.g. GET, PUT, etc.) together. For instance, GETs to /v1/users/ and POSTs/PUTs to /v1/customers/ may be counted as two different API groups. This allows us to offer a higher limit on lightweight requests than we would be able to on more resource intensive request types.
API responses will have the following headers to provide rate limiting statistics about the limit it''s closest to hitting.
- `x-rate-limit-limit`: Request limit enforced for this endpoint, some endpoints may allow bursting over this limit
- `x-rate-limit-remaining`: Requests left in the enforcement window
- `x-rate-limit-reset`: Seconds remaining before this enforcement window ends (as a decimal).
# Model Context Protocol (MCP)
You can connect AI agents and tools to GorillaDesk via the Model Context Protocol. See the GorillaDesk MCP documentation.'
x-logo:
url: https://cdn.gorilladesk.com/assets/images/gorilladesk.png
altText: GorillaDesk logo
servers:
- url: https://api.gorilladesk.com/v1
security:
- Bearer: []
tags:
- name: Customers
paths:
/customers/{customerId}/locations:
post:
operationId: addCustomerLocation
summary: Add a customer location
description: 'Add another location to an existing customer. The first location is sent in `location` when creating the customer.
The response carries the new location id only. Read the stored location — including the values filled in for the fields you omitted — with `GET /customers/{customerId}?include=locations`.'
tags:
- Customers
parameters:
- in: path
name: customerId
description: Customer Id
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/Location'
required: true
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
id:
description: Id of the new location.
type: string
'400':
$ref: '#/paths/~1jobs/get/responses/403'
'401':
$ref: '#/paths/~1jobs/get/responses/401'
'404':
$ref: '#/paths/~1jobs~1%7BjobId%7D/get/responses/404'
components:
schemas:
Location:
type: object
description: A physical location associated with a customer.
required:
- address_line_1
- city
- state
- zip
properties:
id:
description: Location ID.
type: string
example: 5aXrGzNyLY
readOnly: true
name:
description: Location name (e.g. Home, Office).
type: string
example: Home
address_to:
description: Attention line for this address.
type: string
example: John Doe
address_line_1:
description: Primary street address.
type: string
example: 523 East 72nd Street
address_line_2:
description: Secondary street address (apartment, suite, etc.).
type: string
example: ''
city:
description: City.
type: string
example: New York
state:
description: State or province.
type: string
example: NY
zip:
description: Postal / ZIP code.
type: string
example: '10021'
county:
description: County.
type: string
example: ''
billing_to:
description: Attention line for billing address.
type: string
example: John Doe
billing_address_line_1:
description: Billing street address.
type: string
example: 523 East 72nd Street
billing_address_line_2:
description: Billing secondary address.
type: string
example: ''
billing_city:
description: Billing city.
type: string
example: New York
billing_state:
description: Billing state.
type: string
example: NY
billing_zip:
description: Billing postal code.
type: string
example: '10021'
latitude:
description: Latitude coordinate.
type: string
example: ''
longitude:
description: Longitude coordinate.
type: string
example: ''
note:
description: Location notes.
type: string
example: Lorem ipsum dolor sit amet, consectetuer adipiscing eliti
securitySchemes:
Bearer:
type: http
scheme: bearer
x-sidebar-links:
- label: Model Context Protocol (MCP)
url: https://api.gorilladesk.com/mcp/v1/docs
target: _blank