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

Spruce Health Contacts API

The Contacts API from Spruce Health — 6 operation(s) for contacts.

Spruce Health Contacts API is one of 15 APIs that Spruce Health 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, and an API reference.

This API exposes 11 operations across 6 paths, and defines 101 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

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

11 operations 6 paths 101 schemas 2 DELETE4 GET1 PATCH4 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://api.sprucehealth.com/v1
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

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

  • spruceAPIToken — API token provided by Spruce should be passed in an "Authorization" header with the value "Bearer "

Paths & Operations 11

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

Contacts 11
GET
/contacts
List contacts
ListContacts 2 params → 200400500
POST
/contacts
Create a contact
CreateContact 1 param body → 201400422500
DELETE
/contacts/{contactId}
Delete a contact
DeleteContact 1 param → 200400404500
GET
/contacts/{contactId}
Get a contact by Spruce Contact ID
Contact 1 param → 200400404500
PATCH
/contacts/{contactId}
Update a contact
UpdateContact 2 params body → 200400404422500
GET
/contacts/{contactId}/conversations
List the conversations associated with a contact
ContactConversations 1 param → 200400404500
DELETE
/contacts/{contactId}/integrationlinks
Delete an integration link
DeleteContactIntegrationLink 3 params body → 200400404500
GET
/contacts/{contactId}/integrationlinks
List the integration links associated with a contact
ContactIntegrationLinks 1 param → 200400404500
POST
/contacts/{contactId}/integrationlinks
Create an integration link
CreateContactIntegrationLink 4 params body → 201400422500
POST
/contacts/{contactId}/invite
Invite patient to Spruce
SendInvite 1 param body → 200400404500
POST
/contacts/search
Search contacts
SearchContacts 2 params body → 200400500

Schemas 101

The contract defines 101 schemas that model the data the API accepts and returns. The most detailed are contact (27 properties), conversation (17 properties), createContact (15 properties), updateContact (15 properties). Each schema is shown below with its type and property counts.

contact_searchInviteFilter
object
2 properties 2 required
contact_organizationContactFields
array
Fields on a contact that are custom
contact_displayName
string
The contact's full name for easy display to a user. This is determined by combining the givenName, middleName, and familyName, or if those are all empty, falli…
conversation_tagId
string
Spruce's conversation tag ID
objectType
string
String representing the object's type
faxNumberInput
object
2 properties 1 required
paginationToken
string
Token given in a previous response to allow requesting the next page
contact_faxNumbers
array
contact_searchCategoryFilters
array
emailAddress
object
3 properties 2 required
contact_organizationContactFieldInput
object
2 properties 2 required
contact_searchGenderFilters
array
contact_emailAddressInputs
array
conversation_tagValue
string
The text value of a conversation tag
faxNumber
object
4 properties 3 required
createContact
object
15 properties
conversation_tags
array
contact_internalMemberIds
array
The ids of the teammates, teams and/or your organization that are members of the contact. Contact Membership must be enabled for the organization for this fiel…
contact_searchEmailAddressFilters
array
contact_searchGenderFilter
object
2 properties 2 required
conversation_id
string
Spruce's conversation ID
contact_genderDetail
string
Optional free-text details for gender
contact_createContactIntegrationLink
object
3 properties
contact
object
27 properties 20 required
contact_categoryInput
string
conversation
object
17 properties 10 required
phoneNumber
object
4 properties 3 required
contact_searchPhoneNumberFilters
array
contact_emailAddresses
array
phoneNumberDisplayValue
string
The contact phone number in an easily readable format.
updateContact
object
Any omitted or null field will not be updated. To clear a field, pass an empty value such as "" or []
15 properties
emailAddressValue
string
contact_searchFaxNumberFilters
array
searchListMatchFilter
string
contact_tagValue
string
The text value of a contact tag
contact_companyName
string
The contact's company. This field can also be used to specify the name of a non-patient contact, such as another healthcare facility.
contact_searchTagFilter
object
2 properties 2 required
contact_category
string
contact_tagIds
array
An array of Spruce contact tag ids
contact_searchInviteFilters
array
contact_tag
object
3 properties 3 required
contact_customContactField
object
3 properties 3 required
hasMore
boolean
searchTotalCountRelation
string
The relation to use when comparing the total number of available search to the value specified in the results count field. A value of gte means that the count…
emailAddressInput
object
2 properties 1 required
contact_givenName
string
The contact's given name (typically first name in US)
phoneNumberLabel
string
A label for the phone number such as 'Work', 'Home', 'Cell', etc.
contact_gender
string
contact_organizationContactFieldInputs
array
Fields on a contact that are custom to your organization
contact_integrationLinkType
string
contact_searchAgeFilters
array
contact_searchFaxNumberFilter
object
2 properties 2 required
contact_searchTagFilters
array
contact_searchCreatedTimeFilter
object
2 properties 2 required
contact_customFieldValue
string
The value of the field
contact_searchCreatedTimeFilters
array
error
object
3 properties 3 required
contact_searchPhoneNumberFilter
object
2 properties 2 required
contact_integrationLink
object
4 properties 3 required
contact_faxNumberInputs
array
contact_phoneNumbers
array
endpoint
object
7 properties 6 required
contact_organizationContactField
object
3 properties 3 required
contact_externalId
string
The id of a contact in an external system.
contact_customContactFields
array
Fields on a contact that are custom
entityContactID
string
Spruce's phone number ID
contact_searchOrganizationContactFieldFilters
array
contact_searchNameFilter
object
2 properties 2 required
contact_searchIntegrationIDFilters
array
contact_pronouns
string
The contact's pronouns
contact_organizationContactFieldId
string
Spruce's contact organization contact custom field ID
phoneNumberValue
string
The contact phone number. An acceptable phone number is in the format 2065551234, +12065551234, (206) 555-1234, or 206-555-1234.
searchComparisonFilter
string
contact_searchAgeFilter
object
2 properties 2 required
sendInvite
object
3 properties 2 required
contact_tags
array
contact_searchIntegrationIDFilter
object
2 properties 2 required
contact_searchInviteStateFilter
string
send_invite_internalEndpointId
string
Organization's internal secure endpoint that will be used to send the invite.
contactSearch
object
2 properties
contact_searchNameFilters
array
contact_customFieldName
string
A name for the field
contact_integrationLinks
array
Links between a contact and an integrated external system.
totalCount
integer
contact_phoneNumberInputs
array
contact_searchEmailAddressFilter
object
2 properties 2 required
contact_searchStructuredFilter
object
12 properties
contact_deleteContactIntegrationLink
object
2 properties
send_invite_destinationId
string
The id of the phone number or email to send the invite to.
contact_dateOfBirth
string
The contact's date of birth in the format YYYY-MM-DD.
contact_searchCategoryFilter
object
2 properties 2 required
endpoint_id
string
The id of the endpoint. For secure (Spruce Link) endpoints, the id format depends on where the endpoint is returned: the list internal endpoints API returns th…
contact_middleName
string
The contact's middle name
send_invite_customMessage
string
The message to send to the invitee.
conversation_tag
object
3 properties 3 required
contact_tagId
string
Spruce's contact tag ID
contact_searchOrganizationContactFieldFilter
object
2 properties 2 required
contact_customContactFieldId
string
Spruce's contact contact custom field ID
phoneNumberInput
object
2 properties 1 required
contact_familyName
string
The contact's family name (typically last name in US)
contact_id
string
Spruce's contact ID

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

spruce-health-contacts-api-openapi.yml Raw ↑

Other APIs Spruce Health publishes across the network.

Spruce Health Contact Fields API
Spruce Health Contact Tags API
Spruce Health Conversation Item API
Spruce Health Conversation Tags API
Spruce Health Conversations API
Spruce Health Internal Endpoints API
Spruce Health Media API
Spruce Health Organization API
Spruce Health Phone Lines API
Spruce Health Saved Messages API
Spruce Health Scheduled Messages API
Spruce Health Teams API
Where this information came from

This is an independent, third-party profile of Spruce Health 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.