August Health

August Health Contacts (v1) API

The Contacts (v1) API from August Health — 3 operation(s) for contacts (v1).

GitHub OpenAPI

Operations 4

POST /v1/organizations/{orgId}/facilities/{facilityId}/people/{personId}/contacts Create contact #
GET /v1/organizations/{orgId}/facilities/{facilityId}/people/{personId}/contacts List contacts #
GET /v1/organizations/{orgId}/facilities/{facilityId}/people/{personId}/contacts/{contactId} Get contact #
PUT /v1/organizations/{orgId}/facilities/{facilityId}/people/{personId}/contacts/{contactId}/responsiblePerson Sets the specified Contact as the Responsible Person for a given Person #

Documentation

📖
Documentation
https://developer.augusthealth.com
📖
APIReference
https://developer.augusthealth.com/reference
📖
GettingStarted
https://developer.augusthealth.com/docs/getting-started
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/august-health/refs/heads/main/authentication/august-health-authentication.yml
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/august-health/refs/heads/main/rate-limits/august-health-rate-limits.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/august-health/refs/heads/main/openapi/august-health-contacts-v1-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/august-health/refs/heads/main/json-schema/august-health-com-august-api-integrations-models-people-v1-person-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/august-health/refs/heads/main/json-schema/august-health-com-august-api-integrations-models-care-v1-routine-administration-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/august-health/refs/heads/main/json-schema/august-health-com-august-api-integrations-models-census-v1-census-person-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/august-health/refs/heads/main/json-schema/august-health-com-august-api-integrations-models-medication-orders-v1-medication-order-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/august-health/refs/heads/main/json-schema/august-health-com-august-api-integrations-models-people-v1-create-person-request-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/august-health/refs/heads/main/json-schema/august-health-com-august-api-integrations-models-medication-administrations-v1-medication-administration-schema.json

Other Resources

🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/august-health/refs/heads/main/asyncapi/august-health-events-asyncapi.yml
🔗
LLMsTxt
https://raw.githubusercontent.com/api-evangelist/august-health/refs/heads/main/llms/august-health-llms.txt

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/august-health:august-health-contacts-v1-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API 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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

august-health-contacts-v1-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: August Health Integrations Contacts (v1) API
  version: '1.0'
servers:
- url: https://integrations.staging.augusthealth.com
security:
- BearerAuth: []
tags:
- name: Contacts (v1)
paths:
  /v1/organizations/{orgId}/facilities/{facilityId}/people/{personId}/contacts:
    post:
      description: Create a new contact for a person.
      operationId: createContactV1
      parameters:
      - in: path
        name: orgId
        required: true
        schema:
          type: string
      - in: path
        name: facilityId
        required: true
        schema:
          type: string
      - in: path
        name: personId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/com.august.api.integrations.models.contacts.v1.CreateContactRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  data:
                    $ref: '#/components/schemas/com.august.api.integrations.models.contacts.v1.Contact'
                type: object
          description: The newly created contact.
      summary: Create contact
      tags:
      - Contacts (v1)
    get:
      description: List contacts for person.
      operationId: listContactsV1
      parameters:
      - in: path
        name: orgId
        required: true
        schema:
          type: string
      - in: path
        name: facilityId
        required: true
        schema:
          type: string
      - in: path
        name: personId
        required: true
        schema:
          type: string
      - description: The comma-delimited list of fields to retrieve.
        in: query
        name: fields
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  data:
                    items:
                      $ref: '#/components/schemas/com.august.api.integrations.models.contacts.v1.Contact'
                    type: array
                  meta:
                    $ref: '#/components/schemas/com.august.api.integrations.models.common.ApiResponseMetadata'
                type: object
          description: Successfully listed contacts.
      summary: List contacts
      tags:
      - Contacts (v1)
  /v1/organizations/{orgId}/facilities/{facilityId}/people/{personId}/contacts/{contactId}:
    get:
      description: Get details for a specific contact.
      operationId: getContactV1
      parameters:
      - in: path
        name: orgId
        required: true
        schema:
          type: string
      - in: path
        name: facilityId
        required: true
        schema:
          type: string
      - in: path
        name: personId
        required: true
        schema:
          type: string
      - in: path
        name: contactId
        required: true
        schema:
          type: string
      - description: The comma-delimited list of fields to retrieve.
        in: query
        name: fields
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  data:
                    $ref: '#/components/schemas/com.august.api.integrations.models.contacts.v1.Contact'
                type: object
          description: The specified contact's details.
      summary: Get contact
      tags:
      - Contacts (v1)
  /v1/organizations/{orgId}/facilities/{facilityId}/people/{personId}/contacts/{contactId}/responsiblePerson:
    put:
      operationId: setResponsiblePersonV1
      parameters:
      - in: path
        name: orgId
        required: true
        schema:
          type: string
      - in: path
        name: facilityId
        required: true
        schema:
          type: string
      - in: path
        name: personId
        required: true
        schema:
          type: string
      - in: path
        name: contactId
        required: true
        schema:
          type: string
      responses:
        '204':
          description: Successfully set the specified Contact as the Responsible Person for the given Person.
        '403':
          description: User does not have the IntegrationsApiContactsV1Access feature flag enabled or does not have permission to set Contact as the Responsible Person.
      summary: Sets the specified Contact as the Responsible Person for a given Person
      tags:
      - Contacts (v1)
components:
  schemas:
    com.august.api.integrations.models.contacts.v1.GenericOrganizationContact:
      properties:
        address:
          $ref: '#/components/schemas/com.august.api.integrations.models.common_metadata.v1.Address'
        name:
          $ref: '#/components/schemas/com.august.api.integrations.models.common_metadata.v1.HumanName'
        telecom:
          items:
            $ref: '#/components/schemas/com.august.api.integrations.models.contacts.v1.ContactPoint'
          type: array
      required:
      - telecom
    com.august.protos.address.Address.AddressUse:
      enum:
      - ADDRESS_USE_HOME
      - ADDRESS_USE_WORK
      - ADDRESS_USE_TEMP
      - ADDRESS_USE_OLD
      - ADDRESS_USE_BILLING
      type: string
    com.august.api.integrations.models.common.ApiResponseMetadata:
      properties:
        limit:
          description: The limit used for a paginated request for the query
          format: int32
          type: integer
        offset:
          description: The offset used for a paginated request for the query
          format: int32
          type: integer
        total:
          description: The total number of available items for the query
          format: int32
          type: integer
      required:
      - total
      - limit
      - offset
    com.august.protos.contact_point.ContactPoint.ContactPointSystem:
      enum:
      - CONTACT_POINT_SYSTEM_PHONE
      - CONTACT_POINT_SYSTEM_FAX
      - CONTACT_POINT_SYSTEM_EMAIL
      type: string
    com.august.protos.human_name.HumanName.Pronouns:
      enum:
      - PRONOUNS_SHE_HER
      - PRONOUNS_HE_HIM
      - PRONOUNS_THEY_THEM
      - PRONOUNS_SHE_THEY
      - PRONOUNS_HE_THEY
      - PRONOUNS_ZE_HIR
      type: string
    com.august.protos.contact.Contact.ContactRelationship:
      enum:
      - CONTACT_RELATIONSHIP_PERSONAL
      - CONTACT_RELATIONSHIP_FAMMEMB
      - CONTACT_RELATIONSHIP_CHILD
      - CONTACT_RELATIONSHIP_GRNDCHILD
      - CONTACT_RELATIONSHIP_SPS
      - CONTACT_RELATIONSHIP_SIB
      - CONTACT_RELATIONSHIP_NIENEPH
      - CONTACT_RELATIONSHIP_GRNIENEPH
      - CONTACT_RELATIONSHIP_COUSN
      - CONTACT_RELATIONSHIP_FRND
      - CONTACT_RELATIONSHIP_CHILD_INLAW
      - CONTACT_RELATIONSHIP_CLINICIAN
      - CONTACT_RELATIONSHIP_PHYSICIAN
      - CONTACT_RELATIONSHIP_NURSE_PRACTITIONER
      - CONTACT_RELATIONSHIP_PHYSICIAN_ASSISTANT
      - CONTACT_RELATIONSHIP_PHARMACIST
      - CONTACT_RELATIONSHIP_NURSE
      - CONTACT_RELATIONSHIP_SKILLED_THERAPIST
      - CONTACT_RELATIONSHIP_PSYCHOLOGIST
      - CONTACT_RELATIONSHIP_DIETICIAN
      - CONTACT_RELATIONSHIP_SOCIAL_WORKER
      - CONTACT_RELATIONSHIP_DENTIST
      - CONTACT_RELATIONSHIP_PODIATRIST
      - CONTACT_RELATIONSHIP_PROFESSIONAL
      - CONTACT_RELATIONSHIP_REFERRAL_AGENT
      - CONTACT_RELATIONSHIP_PLACEMENT_AGENT
      - CONTACT_RELATIONSHIP_CONSERVATOR
      - CONTACT_RELATIONSHIP_LEGALLY_RESPONSIBLE
      - CONTACT_RELATIONSHIP_CASE_MANAGER
      - CONTACT_RELATIONSHIP_RELIGIOUS_ADVISOR
      - CONTACT_RELATIONSHIP_THIRD_PARTY_PAYER
      - CONTACT_RELATIONSHIP_FIDUCIARY
      - CONTACT_RELATIONSHIP_FUNERAL_HOME
      - CONTACT_RELATIONSHIP_VETERINARIAN
      - CONTACT_RELATIONSHIP_GENERAL_PRACTITIONER
      - CONTACT_RELATIONSHIP_MENTAL_HEALTH_PROVIDER
      - CONTACT_RELATIONSHIP_HOSPICE_PROVIDER
      - CONTACT_RELATIONSHIP_RESPONSIBLE_PERSON
      - CONTACT_RELATIONSHIP_FINANCIAL_PAYMENT_OF_CARE
      - CONTACT_RELATIONSHIP_FINANCIAL_POWER_OF_ATTORNEY
      - CONTACT_RELATIONSHIP_MEDICAL_POWER_OF_ATTORNEY
      - CONTACT_RELATIONSHIP_C
      - CONTACT_RELATIONSHIP_FORM_CONTRIBUTOR
      - CONTACT_RELATIONSHIP_RELEASE_OF_INFORMATION
      - CONTACT_RELATIONSHIP_PERSONAL_PROPERTY
      - CONTACT_RELATIONSHIP_OTHER
      - CONTACT_RELATIONSHIP_SELF
      - CONTACT_RELATIONSHIP_N
      type: string
    com.august.api.integrations.models.contacts.v1.GenericOrganization:
      properties:
        address:
          items:
            $ref: '#/components/schemas/com.august.api.integrations.models.common_metadata.v1.Address'
          type: array
        contact:
          items:
            $ref: '#/components/schemas/com.august.api.integrations.models.contacts.v1.GenericOrganizationContact'
          type: array
        name:
          type: string
        telecom:
          items:
            $ref: '#/components/schemas/com.august.api.integrations.models.contacts.v1.ContactPoint'
          type: array
      required:
      - telecom
      - address
      - contact
    com.august.api.integrations.models.contacts.v1.ExternalFields:
      properties:
        yardi:
          $ref: '#/components/schemas/com.august.api.integrations.models.contacts.v1.YardiFields'
    com.august.api.integrations.models.contacts.v1.Contact:
      properties:
        address:
          $ref: '#/components/schemas/com.august.api.integrations.models.common_metadata.v1.Address'
        clinicalSpecialty:
          type: string
        externalFields:
          $ref: '#/components/schemas/com.august.api.integrations.models.contacts.v1.ExternalFields'
        id:
          type: string
        name:
          $ref: '#/components/schemas/com.august.api.integrations.models.common_metadata.v1.HumanName'
        note:
          type: string
        organization:
          $ref: '#/components/schemas/com.august.api.integrations.models.contacts.v1.GenericOrganization'
        relationship:
          items:
            $ref: '#/components/schemas/com.august.protos.contact.Contact.ContactRelationship'
          type: array
        telecom:
          items:
            $ref: '#/components/schemas/com.august.api.integrations.models.contacts.v1.ContactPoint'
          type: array
      required:
      - id
      - relationship
      - name
      - telecom
    com.august.api.integrations.models.contacts.v1.ContactPoint:
      properties:
        rank:
          format: int32
          type: integer
        system:
          $ref: '#/components/schemas/com.august.protos.contact_point.ContactPoint.ContactPointSystem'
        use:
          $ref: '#/components/schemas/com.august.protos.contact_point.ContactPoint.ContactPointUse'
        value:
          type: string
      required:
      - system
      - use
    com.august.api.integrations.models.contacts.v1.CreateContactRequest:
      properties:
        address:
          $ref: '#/components/schemas/com.august.api.integrations.models.common_metadata.v1.Address'
        clinicalSpecialty:
          type: string
        name:
          $ref: '#/components/schemas/com.august.api.integrations.models.common_metadata.v1.HumanName'
        note:
          type: string
        organization:
          $ref: '#/components/schemas/com.august.api.integrations.models.contacts.v1.GenericOrganization'
        relationship:
          items:
            $ref: '#/components/schemas/com.august.protos.contact.Contact.ContactRelationship'
          type: array
        telecom:
          items:
            $ref: '#/components/schemas/com.august.api.integrations.models.contacts.v1.ContactPoint'
          type: array
      required:
      - relationship
      - name
      - telecom
    com.august.api.integrations.models.contacts.v1.YardiFields:
      properties:
        extRefId:
          type: string
    com.august.api.integrations.models.common_metadata.v1.Address:
      properties:
        city:
          type: string
        line:
          items:
            type: string
          type: array
        postalCode:
          type: string
        state:
          type: string
        text:
          type: string
        use:
          $ref: '#/components/schemas/com.august.protos.address.Address.AddressUse'
      required:
      - line
    com.august.protos.contact_point.ContactPoint.ContactPointUse:
      enum:
      - CONTACT_POINT_USE_HOME
      - CONTACT_POINT_USE_WORK
      - CONTACT_POINT_USE_MOBILE
      - CONTACT_POINT_USE_PAGER
      - CONTACT_POINT_USE_EMERGENCY
      type: string
    com.august.api.integrations.models.common_metadata.v1.HumanName:
      properties:
        family:
          type: string
        given:
          items:
            type: string
          type: array
        maiden:
          type: string
        preferredName:
          type: string
        prefix:
          type: string
        pronouns:
          $ref: '#/components/schemas/com.august.protos.human_name.HumanName.Pronouns'
        suffix:
          type: string
      required:
      - given
  securitySchemes:
    BearerAuth:
      scheme: bearer
      type: http
x-provenance:
  method: searched
  source: https://developer.augusthealth.com/reference
  harvested: '2026-10-14'
  tool: harvest-readme-openapi.py
  note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
  assembled_from:
  - https://developer.augusthealth.com/reference/bulkchartroutineadministrationsv1.md
  - https://developer.augusthealth.com/reference/createcontactv1-1.md
  - https://developer.augusthealth.com/reference/createincidentv1.md
  - https://developer.augusthealth.com/reference/createpersonv1-1.md
  - https://developer.augusthealth.com/reference/createresidentbiographyv1.md
  - https://developer.augusthealth.com/reference/createtokenv1.md
  - https://developer.augusthealth.com/reference/createvisitorlogv1.md
  - https://developer.augusthealth.com/reference/createvitalv1.md
  - https://developer.augusthealth.com/reference/createwebhooksportalaccessurlv1.md
  - https://developer.augusthealth.com/reference/deletevisitorlogv1.md
  - https://developer.augusthealth.com/reference/extractresidentbiographyv1.md
  - https://developer.augusthealth.com/reference/getadmissionagreementpdfv1.md
  - https://developer.augusthealth.com/reference/getadmissionagreementv1.md
  - https://developer.augusthealth.com/reference/getadmissionhistoryv1.md
  - https://developer.augusthealth.com/reference/getassessmentv1.md
  - https://developer.augusthealth.com/reference/getbillingsummaryv1.md
  - https://developer.augusthealth.com/reference/getcensuspersonv1.md
  - https://developer.augusthealth.com/reference/getcontactv1-1.md
  - https://developer.augusthealth.com/reference/getfacilityadmissionhistoryv1.md
  - https://developer.augusthealth.com/reference/getfacilitybedassignmenthistoryv1.md
  - https://developer.augusthealth.com/reference/getimmunizationv1.md
  - https://developer.augusthealth.com/reference/getincidentv1.md
  - https://developer.augusthealth.com/reference/getlatestadmissionagreementv1.md
  - https://developer.augusthealth.com/reference/getlatestassessmentv1.md
  - https://developer.augusthealth.com/reference/getlatestresidentbiographyv1.md
  - https://developer.augusthealth.com/reference/getpersonprofilephotov1.md
  - https://developer.augusthealth.com/reference/getpersonv1-1.md
  - https://developer.augusthealth.com/reference/getstatementpdfv1.md
  - https://developer.augusthealth.com/reference/getvitalv1.md
  - https://developer.augusthealth.com/reference/listbedassignmentsv1.md
  - https://developer.augusthealth.com/reference/listcensusv1.md
  - https://developer.augusthealth.com/reference/listcontactsv1-1.md
  - https://developer.augusthealth.com/reference/listfacilitiesv1-1.md
  - https://developer.augusthealth.com/reference/listfacilitybillingsummariesv1.md
  - https://developer.augusthealth.com/reference/listfacilityincidentsv1.md
  - https://developer.augusthealth.com/reference/listfacilitymedicationadministrationsv1.md
  - https://developer.augusthealth.com/reference/listfacilitymedicationordersv1.md
  - https://developer.augusthealth.com/reference/listfacilityroutineadministrationsv1.md
  - https://developer.augusthealth.com/reference/listimmunizationsv1.md
  - https://developer.augusthealth.com/reference/listmedpassesv1.md
  - https://developer.augusthealth.com/reference/listorganizationsv1.md
  - https://developer.augusthealth.com/reference/listpeoplev1-1.md
  - https://developer.augusthealth.com/reference/listpersonincidentsv1.md
  - https://developer.augusthealth.com/reference/listpersonmedicationadministrationsv1.md
  - https://developer.augusthealth.com/reference/listpersonmedicationordersv1.md
  - https://developer.augusthealth.com/reference/listprncarecategoriesv1.md
  - https://developer.augusthealth.com/reference/listresidentbillingtransactionsv1.md
  - https://developer.augusthealth.com/reference/listroomsv1.md
  - https://developer.augusthealth.com/reference/listroutineadministrationsv1.md
  - https://developer.augusthealth.com/reference/listshiftsv1.md
  - https://developer.augusthealth.com/reference/listtasksv1.md
  - https://developer.augusthealth.com/reference/listusersv1.md
  - https://developer.augusthealth.com/reference/listvisitorlogsv1.md
  - https://developer.augusthealth.com/reference/listvitalsv1.md
  - https://developer.augusthealth.com/reference/patchpersonv1.md
  - https://developer.augusthealth.com/reference/recordchargesv1.md
  - https://developer.augusthealth.com/reference/recorddepositv1.md
  - https://developer.augusthealth.com/reference/searchstatementsv1.md
  - https://developer.augusthealth.com/reference/setresponsiblepersonv1-1.md
  - https://developer.augusthealth.com/reference/updateincidentv1.md
  - https://developer.augusthealth.com/reference/updatevitalv1.md
  merge:
    pages: 61
    deduped: 634
    conflicts_kept_first: 0