# Spruce Health Documentation > Documentation for Spruce Health This file lists one part of the documentation. The full index is at https://developer.sprucehealth.com/llms.txt. ## API Reference: Spruce Health API - Contacts - [List contacts](https://developer.sprucehealth.com/reference/listcontacts.md): This operation lists all contacts available to a given organization. The `hasMore` field can be used to determine if there are remaining results to list. The `paginationToken` field can be provided… - [Create a contact](https://developer.sprucehealth.com/reference/createcontact.md): This operation creates a contact within an organization. Creating a new contact requires at least of the following fields to be populated (`givenName`, `familyName`, `phoneNumbers`, `faxNumbers`,… - [Delete a contact](https://developer.sprucehealth.com/reference/deletecontact.md): This operation deletes a specific contact by id. See the `canDelete` field on a given contact to determine if deletion is allowed. - [Get a contact by Spruce Contact ID](https://developer.sprucehealth.com/reference/contact.md): This operation retrieves a specific contact by id. - [Update a contact](https://developer.sprucehealth.com/reference/updatecontact.md): This operation updates a specific contact by id. Fields provided in the input object will be updated, omitted fields *(null)* will be unchanged. - [List the conversations associated with a contact](https://developer.sprucehealth.com/reference/contactconversations.md): This operation retrieves the conversations associated with a contact - [Delete an integration link](https://developer.sprucehealth.com/reference/deletecontactintegrationlink.md): This operation deletes a specific integration link associated with a contact. - [List the integration links associated with a contact](https://developer.sprucehealth.com/reference/contactintegrationlinks.md): This operation retrieves the integration links associated with a contact - [Create an integration link](https://developer.sprucehealth.com/reference/createcontactintegrationlink.md): This operation creates a link between a contact and an external system with which the Spruce account is integrated. - [Invite patient to Spruce](https://developer.sprucehealth.com/reference/sendinvite.md): This operation sends an invite to a patient contact: - If the contact is invited for the first time, a new secure conversation will be created, - If the contact is already invited, the invite will be… - [Search contacts](https://developer.sprucehealth.com/reference/searchcontacts.md): This operation searches all contacts available to a given organization and returns a resulting set of results. The `hasMore` field can be used to determine if there are remaining results to list.… - Contact Fields - [List all organization contact fields available to the organization](https://developer.sprucehealth.com/reference/contactfields.md): This operation lists all organization contact fields. These fields appear on all contacts in the interface. - [Create an organization contact field](https://developer.sprucehealth.com/reference/createcontactfield.md): This operation creates an organization contact field for the given organization. This field will appear on all contacts in the interface. Requesting creation of an already existing field will result… - Contact Tags - [List all contact tags available to the organization](https://developer.sprucehealth.com/reference/contacttags.md): This operation lists all contact tags available to a given organization. The `hasMore` field can be used to determine if there are remaining results to list. The `paginationToken` field can be… - [Create a contact tag](https://developer.sprucehealth.com/reference/createcontacttag.md): This operation creates a contact tag for the given organization. This tag can then be applied to contacts in subsequent operations. Requesting creation of an already existing tag will result in a… - Conversation Item - [Delete a conversation item](https://developer.sprucehealth.com/reference/deleteconversationitem.md): Deletes a specific conversation item by ID. This operation follows the same business rules as the in-app delete mechanism, including permission checks and content restrictions. **Soft Delete… - [Get a conversation item for a given id](https://developer.sprucehealth.com/reference/conversationitem.md): This operation fetches a specific conversation item for the provided id. - [List the read receipts for a conversation item](https://developer.sprucehealth.com/reference/conversationitemreadreceipts.md): Lists everyone who has read a specific conversation item, and when they first read it. A read receipt records that someone opened the item in Spruce. Teammates produce a read receipt for any item… - Conversations - [List and filter all conversations available to the organization](https://developer.sprucehealth.com/reference/listconversations.md): This operation lists all conversations available to the organization. This is an eventually consistent view and may take a short time before new conversations appear in results. To iterate through… - [Create a new conversation](https://developer.sprucehealth.com/reference/createconversation.md): This operation creates a new conversation within an organization. The following conversation types are supported: ### Secure Conversations (`type: "secure"`) A secure conversation can be started… - [Get a conversation for a given id](https://developer.sprucehealth.com/reference/conversation.md): This operation fetches a specific conversation for the provided id. - [Update a conversation](https://developer.sprucehealth.com/reference/updateconversation.md): This operation updates a specific conversation by id. Fields provided in the input object will be updated, omitted fields *(null)* will be unchanged. - [List and filter all conversation items in a conversation](https://developer.sprucehealth.com/reference/conversationitems.md): This operation lists all conversations items available in a conversation. This is an eventually consistent view and may take a short time before new conversation items appear in results. - [Post a message to a specific conversation](https://developer.sprucehealth.com/reference/postconversationmessage.md): This operation posts a message in a conversation as specified by the conversationId. You can retrieve the conversationId by [listing the conversations for a contact](/reference/contactconversations)… - Scheduled Messages - [List any messages scheduled in a conversation](https://developer.sprucehealth.com/reference/listconversationscheduledmessages.md): This operation lists the messages that are scheduled in a conversation. - [Schedule a message to be sent in a conversation](https://developer.sprucehealth.com/reference/scheduleconversationmessage.md): This operation creates a scheduled message to be sent in a conversation at the designated time. If no author is specified, the message will be sent as the organization. - [List any messages scheduled for the organization](https://developer.sprucehealth.com/reference/listscheduledmessages.md): This operation lists the messages that are scheduled to be sent from the organization. - [Delete a scheduled message](https://developer.sprucehealth.com/reference/deletescheduledmessage.md): This operation deletes a scheduled message specified by id. - Conversation Tags - [List all conversation tags available to the organization](https://developer.sprucehealth.com/reference/conversationtags.md): This operation lists all conversation tags available to a given organization. The `hasMore` field can be used to determine if there are remaining results to list. The `paginationToken` field can be… - [Create a conversation tag](https://developer.sprucehealth.com/reference/createconversationtag.md): This operation creates a conversation tag for the given organization. This tag can then be applied to conversations in subsequent operations. Requesting creation of an already existing tag will… - Internal Endpoints - [List all internal endpoints](https://developer.sprucehealth.com/reference/internalendpoints.md): This operation lists all internal endpoints which organizations can use to communicate with. This includes all Spruce phone numbers, fax numbers, email addresses and Spruce Links. You can then [use… - [Send a message from an internal endpoint](https://developer.sprucehealth.com/reference/postmessagefromendpoint.md): This operation sends a message to an external endpoint (phone number or email address) or a contact (secure messaging). Only one of secureEndpoint or smsOrEmailEndpoint should be specified. You will… - [Create an outbound proxy call](https://developer.sprucehealth.com/reference/postcreateproxycall.md): This operation creates an outbound proxy call from an internal endpoint to an external phone number and returns the proxy number for use. To learn more about proxy calling on Spruce, [visit this… - Media - [Upload media](https://developer.sprucehealth.com/reference/uploadmedia.md): This operation uploads media such a images, videos, and files to Spruce for use in messaging. Uploading a file will return a media ID that can be used to reference the file in other operations.… - Organization - [List information about the organization](https://developer.sprucehealth.com/reference/organization-1.md): This returns your organization's information. Most importantly, it returns your organization's `id` which will often be used as the owner or a member of other objects. - [List all members of the organization](https://developer.sprucehealth.com/reference/organizationmembers.md): This returns a list of all members of the organization. This includes all teammates and all teams, as well as a reference to the organization itself. - [Get a member of the organization by id](https://developer.sprucehealth.com/reference/organizationmember.md): This operation retrieves a specific organization member (organization, team, or teammate), by id. - Phone Lines - [List all phone lines of the organization](https://developer.sprucehealth.com/reference/phonelines.md): This returns a list of all phone lines of the organization. - [Get a phone line of the organization by id](https://developer.sprucehealth.com/reference/phoneline.md): This operation retrieves a specific phone line by id. - Saved Messages - [List saved messages](https://developer.sprucehealth.com/reference/listsavedmessages.md): Lists all saved messages accessible to the organization. Returns both private and organization-wide saved messages with pagination support. - Teams - [List the members of a team](https://developer.sprucehealth.com/reference/teammembers.md): This operation lists the members of a team identified by id. - [Create a team](https://developer.sprucehealth.com/reference/createteam.md): This operation creates a new team in the organization. The new team has no members; add teammates with the add team members operation. - [Update a team](https://developer.sprucehealth.com/reference/updateteam.md): This operation updates a team identified by id. Currently only the team's name can be changed. - [Add and remove teammates on a team](https://developer.sprucehealth.com/reference/updateteammembers.md): This operation adds teammates to and removes teammates from a team identified by id in a single request. Either all of the changes are applied or, if any id is invalid, none of them are. Only active… - Transcriptions - [Get a transcription by id](https://developer.sprucehealth.com/reference/transcription.md): This operation fetches the full transcription text and its summarization (if available) for the provided transcription id. The transcription id is available on the `transcriptionId` field of… - Webhooks - [List webhook destination endpoints](https://developer.sprucehealth.com/reference/listwebhookendpoints.md): This operation lists the endpoints that an organization has registered for webhooks. - [Create a webhook destination endpoint](https://developer.sprucehealth.com/reference/createwebhookendpoint.md): This operation creates a destination endpoint for webhooks events. - [Delete a webhook destination endpoint by id](https://developer.sprucehealth.com/reference/deletewebhookendpoint.md): This operation deleted a destination endpoint for webhook events by id. - [Get a webhook destination endpoint by id](https://developer.sprucehealth.com/reference/webhookendpoint.md): This operation retrieves a specific destination endpoint for webhooks events by id. - [List events for an endpoint](https://developer.sprucehealth.com/reference/listwebhookendpointevents.md): This operation retrieves information about events that have been attempted to be published to a webhook destination endpoint. Events are queryable for a period of 30 days after creation and are… - [Pause or resume a webhook destination endpoint](https://developer.sprucehealth.com/reference/modifywebhookendpointpaused.md): This operation sets the 'paused' state of a webhook destination endpoint.