> ## Documentation Index
> Fetch the complete documentation index at: https://developer.amplify.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Update a contact

> Customer API v1 endpoint.

Update a contact. Authenticate with a Bearer access token unless the endpoint is the authentication token exchange.


## OpenAPI

````yaml POST /v1/contacts/update
openapi: 3.1.0
info:
  title: Amplify Customer API
  version: 1.0.0
  description: |-
    Canonical contract for the Amplify customer-facing API. This YAML file is
    the source of truth for Postman and Mintlify. Operations marked with
    x-amplify-validation-status: pending were migrated from the legacy Postman
    collection and must be validated before their contract is considered final.
servers:
  - url: https://api.amplify.xyz
    description: Production
  - url: https://dev-api.amplify.xyz
    description: Development
security: []
tags:
  - name: Authentication
  - name: Fax
  - name: Send Faxes
  - name: Receive Faxes
  - name: Manage Faxes
  - name: Workspace
  - name: Numbers
  - name: Contacts
  - name: Documents
  - name: Templates
paths:
  /v1/contacts/update:
    post:
      tags:
        - Contacts
      summary: Update a contact
      description: >-
        Replaces the supported profile, preference, group, and custom-field
        values of an existing contact.
      operationId: postv1ContactsUpdate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                id:
                  type: string
                type:
                  type: string
                is_organization:
                  type: boolean
                first_name:
                  type: string
                middle_name:
                  type: string
                last_name:
                  type: string
                suffix:
                  type: string
                direct_message:
                  type: string
                address:
                  type: string
                address_line_2:
                  type: string
                city:
                  type: string
                state:
                  type: string
                zip:
                  type: string
                country:
                  type: string
                organization_name:
                  type: string
                position:
                  type: string
                notes:
                  type: string
                is_favorite:
                  type: boolean
                is_blocked:
                  type: boolean
                is_accesible_to_others:
                  type: boolean
                fields:
                  type: array
                  items:
                    type: object
                    properties:
                      id:
                        type: integer
                      value:
                        type: string
                groups:
                  type: array
                  items:
                    type: string
                previous_last_name:
                  type: string
                dob:
                  type: string
                gender:
                  type: string
                preferred_language:
                  type: string
                interpreter_needed:
                  type: boolean
                races:
                  type: string
                ethnicity:
                  type: string
                medical_record_number:
                  type: string
                patient_status:
                  type: string
                external_patient_id:
                  type: string
                pcp_internal_contact:
                  type: string
                pcp_external_name:
                  type: string
                emergency_contact_name:
                  type: string
                emergency_contact_relationship:
                  type: string
                emergency_contact_phone:
                  type: string
                preferred_contact_methods:
                  type: string
                sms_opt_in:
                  type: boolean
                email_opt_in:
                  type: boolean
                do_not_contact:
                  type: boolean
                coverage_type:
                  type: string
                insurance_provider:
                  type: string
                plan_name:
                  type: string
                member_id:
                  type: string
                group_number:
                  type: string
                payer_phone:
                  type: string
                subscriber_name:
                  type: string
                subscriber_dob:
                  type: string
                subscriber_relationship:
                  type: string
              required:
                - id
            example:
              id: QrJ3MauNG0w7iFkMIodrMg==
              type: individual
              is_organization: false
              first_name: Primary one
              middle_name: Primary two
              last_name: Contact
              suffix: Jr
              direct_message: ''
              address: Address One
              address_line_2: Address two
              city: Test city
              state: CA
              zip: '898989'
              country: US
              organization_name: sdfdsfds
              position: ''
              notes: ''
              is_favorite: false
              is_blocked: false
              is_accesible_to_others: false
              fields:
                - id: 357
                  value: 1 (205) 369-8533
              groups:
                - '249'
              previous_last_name: test
              dob: '2026-03-19'
              gender: male
              preferred_language: spanish
              interpreter_needed: false
              races: Black or African American
              ethnicity: hispanic_or_latino
              medical_record_number: dfsfsfdsf
              patient_status: active
              external_patient_id: ''
              pcp_internal_contact: ''
              pcp_external_name: ''
              emergency_contact_name: dsffsf
              emergency_contact_relationship: spouse
              emergency_contact_phone: ''
              preferred_contact_methods: Email
              sms_opt_in: false
              email_opt_in: false
              do_not_contact: false
              coverage_type: tertiary
              insurance_provider: ''
              plan_name: ''
              member_id: ''
              group_number: ''
              payer_phone: ''
              subscriber_name: ''
              subscriber_dob: ''
              subscriber_relationship: ''
      responses:
        '200':
          description: Contact updated successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StatusMessageResponse'
              example:
                status: 1
                message: Contact has been updated successfully.
        '422':
          description: >-
            Required fields were not supplied. The live API currently returns
            opaque validation details.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpaqueValidationResponse'
      security:
        - bearerAuth: []
components:
  schemas:
    StatusMessageResponse:
      type: object
      required:
        - status
        - message
      properties:
        status:
          type: integer
          description: Operation result indicator.
        message:
          type: string
          description: Human-readable result message.
    OpaqueValidationResponse:
      type: object
      required:
        - data
      properties:
        data:
          type: string
          description: Opaque validation data returned by the current API implementation.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````