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

# Update contact

> Update a contact and its related information (spouse, children, pets, events)



## OpenAPI

````yaml /openapi.yaml put /contacts/{uuid}
openapi: 3.1.0
info:
  title: Postable API
  version: 1.0.0
  description: API for managing contacts and groups in Postable
servers:
  - url: https://www.postable.com/api/v1
    description: API base URL
security: []
paths:
  /contacts/{uuid}:
    parameters:
      - name: uuid
        in: path
        required: true
        schema:
          type: string
          format: uuid
        description: UUID of the contact
        example: 123e4567-e89b-12d3-a456-426614174000
    put:
      summary: Update contact
      description: >-
        Update a contact and its related information (spouse, children, pets,
        events)
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Contact'
            example:
              first_name: Johnny
              email: johnny.doe@example.com
              birth_day: 16
              children:
                - first_name: Jimmy
                  birth_month: 3
                  birth_day: 12
                  birth_year: 2012
                - first_name: Sally
                  birth_month: 9
                  birth_day: 8
                  birth_year: 2015
                - first_name: Bobby
                  birth_month: 11
                  birth_day: 30
                  birth_year: 2018
              pets:
                - name: Fido
                  birth_month: 4
                  birth_day: 10
                  birth_year: 2018
                  secondary_type: Golden Retriever
      responses:
        '200':
          description: Contact updated successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/Contact'
      security:
        - sanctum: []
components:
  schemas:
    Contact:
      type: object
      properties:
        uuid:
          type: string
          format: uuid
          description: Unique identifier for the contact
        internal_id:
          type: string
          maxLength: 20
          nullable: true
          description: >-
            Your internal identifier for this contact (e.g., customer ID from
            your system)
        prefix:
          type: string
          description: Prefix/title (e.g., Mr., Mrs., Dr.)
        first_name:
          type: string
          description: First name of the contact
        middle_name:
          type: string
          description: Middle name of the contact
        last_name:
          type: string
          description: Last name of the contact
        company:
          type: string
          description: Company name
        email:
          type: string
          format: email
          description: Email address
        phone:
          type: string
          description: Phone number
        address:
          type: string
          description: Street address
        apt:
          type: string
          description: Apartment, suite, or unit number
        city:
          type: string
          description: City
        state:
          type: string
          description: State or province
        zip:
          type: string
          description: ZIP or postal code
        country:
          type: string
          description: Country
        spouse_prefix:
          type: string
          description: Spouse's prefix/title
        spouse_first_name:
          type: string
          description: Spouse's first name
        spouse_middle_name:
          type: string
          description: Spouse's middle name
        spouse_last_name:
          type: string
          description: Spouse's last name
        birth_month:
          type: integer
          minimum: 1
          maximum: 12
          description: Birth month
        birth_day:
          type: integer
          minimum: 1
          maximum: 31
          description: Birth day
        birth_year:
          type: integer
          description: Birth year
        anniversary_month:
          type: integer
          minimum: 1
          maximum: 12
          description: Anniversary month
        anniversary_day:
          type: integer
          minimum: 1
          maximum: 31
          description: Anniversary day
        anniversary_year:
          type: integer
          description: Anniversary year
        spouse_birth_month:
          type: integer
          minimum: 1
          maximum: 12
          description: Spouse's birth month
        spouse_birth_day:
          type: integer
          minimum: 1
          maximum: 31
          description: Spouse's birth day
        spouse_birth_year:
          type: integer
          description: Spouse's birth year
        children:
          type: array
          description: List of children
          items:
            $ref: '#/components/schemas/Child'
        pets:
          type: array
          description: List of pets
          items:
            $ref: '#/components/schemas/Pet'
        notes:
          type: string
          description: Additional notes about the contact
        created_at:
          type: string
          format: date-time
          description: Creation timestamp in ISO-8601 format
        updated_at:
          type: string
          format: date-time
          description: Last update timestamp in ISO-8601 format
      required:
        - first_name
        - last_name
    Child:
      type: object
      properties:
        first_name:
          type: string
          description: First name of the child
        birth_month:
          type: integer
          minimum: 1
          maximum: 12
          description: Birth month of the child
        birth_day:
          type: integer
          minimum: 1
          maximum: 31
          description: Birth day of the child
        birth_year:
          type: integer
          description: Birth year of the child
      required:
        - first_name
    Pet:
      type: object
      properties:
        name:
          type: string
          description: Name of the pet
        birth_month:
          type: integer
          minimum: 1
          maximum: 12
          description: Birth month of the pet
        birth_day:
          type: integer
          minimum: 1
          maximum: 31
          description: Birth day of the pet
        birth_year:
          type: integer
          description: Birth year of the pet
        secondary_type:
          type: string
          description: Type of pet (e.g., Dog, Cat)
      required:
        - name
  securitySchemes:
    sanctum:
      type: http
      scheme: bearer
      bearerFormat: JWT

````