> ## 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.

# Create Contact

> Create a new contact with all related information



## OpenAPI

````yaml POST /contacts
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:
    post:
      summary: Create a new contact
      description: >-
        Creates a new contact with all related information (spouse, children,
        pets, events)
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Contact'
            example:
              prefix: Mr.
              first_name: John
              middle_name: Robert
              last_name: Doe
              company: Acme Inc.
              email: john.doe@example.com
              phone: 555-123-4567
              address: 123 Main St
              apt: Apt 4B
              city: Anytown
              state: CA
              zip: '12345'
              country: United States
              spouse_prefix: Mrs.
              spouse_first_name: Jane
              spouse_middle_name: Marie
              spouse_last_name: Doe
              birth_month: 5
              birth_day: 15
              birth_year: 1980
              anniversary_month: 6
              anniversary_day: 20
              anniversary_year: 2010
              spouse_birth_month: 8
              spouse_birth_day: 25
              spouse_birth_year: 1982
              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
              pets:
                - name: Fido
                  birth_month: 4
                  birth_day: 10
                  birth_year: 2018
                  secondary_type: Dog
              notes: This is a test contact.
      responses:
        '201':
          description: Contact created 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

````