How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Squarespace Contacts API

Manage customer contacts and address book entries for a website: create, read, update, delete, and query contacts; maintain addresses for shipping and fulfillment.

Squarespace Contacts API is one of 13 APIs that Squarespace publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Contacts. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, authentication docs, and rate-limit docs.

This API exposes 11 operations across 5 paths, and defines 27 schemas. It is described by OpenAPI 3.2.0, at version 2.

Requests are made against a single base URL, https://api.squarespace.com.

11 operations 5 paths 27 schemas 2 DELETE4 GET1 PATCH3 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2
Server
https://api.squarespace.com
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

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

Paths & Operations 11

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

Contacts 11

Manage customer contacts and address book entries for a website: create, read, update, delete, and query contacts; maintain addresses for shipping and fulfillment.

GET
/v1/contacts
List contacts
getContacts 4 params → 200400403429
POST
/v1/contacts
Create contact
createContact 2 params body → 201400403409429
POST
/v1/contacts/query
Query contacts
queryContacts 2 params body → 200400403429
DELETE
/v1/contacts/{contactId}
Delete contact
deleteContact 3 params → 204403404429
GET
/v1/contacts/{contactId}
Get contact
getContact 3 params → 200403404429
PATCH
/v1/contacts/{contactId}
Update contact
patchContact 3 params body → 200400403404409429
GET
/v1/contacts/{contactId}/address-book
Get address book
getAddressBook 5 params → 200403404429
POST
/v1/contacts/{contactId}/address-book
Create address book entry
createAddressBookEntry 3 params body → 201400403404429
DELETE
/v1/contacts/{contactId}/address-book/{addressBookEntryId}
Delete address book entry
deleteAddressBookEntry 4 params → 204403404429
GET
/v1/contacts/{contactId}/address-book/{addressBookEntryId}
Get address book entry
getAddressBookEntry 4 params → 200403404429
PUT
/v1/contacts/{contactId}/address-book/{addressBookEntryId}
Replace address book entry
updateAddressBookEntry 4 params body → 200400403404429

Schemas 27

The contract defines 27 schemas that model the data the API accepts and returns. The most detailed are QueryContactsRequest (14 properties), ContactAddress (9 properties), Contact (7 properties), StandardErrorPayload (5 properties). Each schema is shown below with its type and property counts.

CreateContactResponse
object
1 property
CreateAddressBookEntryResponse
object
1 property
AddressBook
object
Address settings for a contact. When there is at least one address book entry, exactly one is the default shipping address; default shipping address is always…
2 properties
UpdateAddressBookEntryRequest
object
2 properties 1 required
IntegerFilter
object
Object for filtering by a min and max integer
2 properties
CreateContactRequest
object
4 properties 4 required
CreateEmail
object
Primary email supplied when creating a contact.
2 properties 1 required
PatchContactRequest
object
Fields to update on an existing contact.
4 properties
GetAddressBookEntryResponse
object
1 property
PaginatedGetContactsResponse
object
2 properties
QueryContactsRequest
object
14 properties
GetContactResponse
object
1 property
PatchEmail
object
Primary email fields for an update request.
2 properties
StandardErrorPayload
object
5 properties
AcceptsMarketing
object
Marketing subscription state for the contact's email.
3 properties
AddressBookEntry
object
An address book entry for a contact.
3 properties
PaginatedQueryContactsResponse
object
2 properties
GetAddressBookResponse
object
2 properties
Email
object
The contact's primary email.
3 properties
PatchContactResponse
object
1 property
DateFilter
object
Object for filtering by before and after dates
2 properties
Contact
object
A contact.
7 properties
PaginationDetails
object
3 properties
UpdateAddressBookEntryResponse
object
1 property
AcceptsMarketingWithDate
object
Contact's marketing settings with joined on date
2 properties
ContactAddress
object
Address properties for a contact.
9 properties 1 required
CreateAddressBookEntryRequest
object
2 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

squarespace-contacts-api-openapi.yml Raw ↑

Other APIs Squarespace publishes across the network.

Squarespace Orders API
Squarespace Products API
Squarespace Inventory API
Squarespace Profiles API
Squarespace Transactions API
Squarespace Webhook Subscriptions API
Squarespace Site API
Squarespace MCP Server
Squarespace Analytics API
Squarespace Discounts API
Squarespace Webhook Subscriptions API
Squarespace Websites API
Where this information came from

This is an independent, third-party profile of Squarespace Contacts API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.