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

# Create a contact

> Creates a new contact with the specified details.



## OpenAPI

````yaml POST /contacts
openapi: 3.0.0
info:
  title: Cogfy Messenger Public API
  version: 1.0.0
  description: API for interacting with the Cogfy Messenger platform
servers:
  - url: https://messenger-public-api.cogfy.com
    description: Production server
  - url: http://localhost:53981
    description: Local server
security:
  - ApiKeyAuth: []
tags: []
paths:
  /contacts:
    post:
      tags:
        - Contacts
      summary: Create a new contact
      description: Creates a new contact with the specified details.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                waProfileName:
                  type: string
                firstName:
                  type: string
                lastName:
                  type: string
                email:
                  type: string
                  format: email
                phone:
                  type: string
                occupation:
                  type: string
                gender:
                  type: string
                birthdate:
                  type: string
                  format: date
                age:
                  type: integer
                notes:
                  type: string
                customProperties:
                  type: object
                  additionalProperties:
                    type: string
                  description: Custom properties associated with the contact
                  example:
                    Favorite Color: Blue
      responses:
        '201':
          description: Contact created successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    format: uuid
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: api-key

````