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

# Create a new Customer Alias

> Create a new Customer Alias



## OpenAPI

````yaml customer.2024-07-30.product.live POST /customer-aliases
openapi: 3.0.0
info:
  title: Customers
  description: Manage customers and contacts
  version: '0.1'
servers:
  - url: https://dev.seqhq.io/api
    description: DEV
  - url: https://sandbox.sequencehq.com/api
    description: SANDBOX
  - url: https://eu.sequencehq.com/api
    description: PRODUCTION
security: []
tags: []
paths:
  /customer-aliases:
    servers: []
    parameters: []
    post:
      tags:
        - Customer Aliases
      summary: Create a new Customer Alias
      description: Create a new Customer Alias
      operationId: postCustomerAliases
      parameters:
        - name: Authorization
          in: header
          description: >-
            Your [API credentials](/reference/authentication). Eg. `Basic
            {credentials}`.
          required: true
          schema:
            type: string
        - name: Sequence-Version
          in: header
          description: Use this header to select an API version
          required: false
          schema:
            type: string
            enum:
              - '2024-07-30'
      requestBody:
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/CreateCustomerAliasEndpointCreateCustomerAliasRequestModel
              example:
                customerId: 01849e70-703e-705a-b59a-d3fd575587e0
                value: external-customer-alias-123
                label: CRM ID
            examples:
              CreateCustomerAliasEndpointCreateCustomerAliasRequestModel:
                summary: ''
                value:
                  customerId: 01849e70-703e-705a-b59a-d3fd575587e0
                  value: external-customer-alias-123
                  label: CRM ID
        required: true
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CustomerAliasResponseModel'
                example:
                  id: 01849e70-0a0f-72ca-ba07-5557dd734d43
                  sequenceAccountId: ec1479a2-6ba1-421f-a7de-0853a20d17a1
                  customerId: 01849e70-703e-705a-b59a-d3fd575587e0
                  value: external-customer-alias-123
                  createdAt: '2022-10-01T00:00:00Z'
                  deletedAt: '2022-10-01T00:00:00Z'
                  label: CRM ID
                  archivedAt: '2022-10-01T00:00:00Z'
              examples:
                CustomerAliasResponseModel:
                  summary: ''
                  value:
                    id: 01849e70-0a0f-72ca-ba07-5557dd734d43
                    sequenceAccountId: ec1479a2-6ba1-421f-a7de-0853a20d17a1
                    customerId: 01849e70-703e-705a-b59a-d3fd575587e0
                    value: external-customer-alias-123
                    createdAt: '2022-10-01T00:00:00Z'
                    deletedAt: '2022-10-01T00:00:00Z'
                    label: CRM ID
                    archivedAt: '2022-10-01T00:00:00Z'
        '400':
          description: Bad Request
          content: {}
        '401':
          description: Unauthorized
          content: {}
        '500':
          description: Internal Server Error
          content: {}
components:
  schemas:
    CreateCustomerAliasEndpointCreateCustomerAliasRequestModel:
      required:
        - customerId
        - value
      type: object
      example:
        customerId: 01849e70-703e-705a-b59a-d3fd575587e0
        value: external-customer-alias-123
        label: CRM ID
      properties:
        customerId:
          type: string
          description: Customer ID
          example: 01849e70-703e-705a-b59a-d3fd575587e0
        value:
          type: string
          description: Alias value
          example: external-customer-alias-123
        label:
          type: string
          description: Alias label
          example: CRM ID
    CustomerAliasResponseModel:
      required:
        - createdAt
        - customerId
        - id
        - sequenceAccountId
        - value
      type: object
      example:
        id: 01849e70-0a0f-72ca-ba07-5557dd734d43
        sequenceAccountId: ec1479a2-6ba1-421f-a7de-0853a20d17a1
        customerId: 01849e70-703e-705a-b59a-d3fd575587e0
        value: external-customer-alias-123
        createdAt: '2022-10-01T00:00:00Z'
        deletedAt: '2022-10-01T00:00:00Z'
        label: CRM ID
        archivedAt: '2022-10-01T00:00:00Z'
      properties:
        id:
          type: string
          description: Unique ID
          example: 01849e70-0a0f-72ca-ba07-5557dd734d43
        sequenceAccountId:
          type: string
          description: Sequence Account ID
          example: ec1479a2-6ba1-421f-a7de-0853a20d17a1
        customerId:
          type: string
          description: Customer ID
          example: 01849e70-703e-705a-b59a-d3fd575587e0
        value:
          type: string
          description: Alias value
          example: external-customer-alias-123
        createdAt:
          type: string
          description: Created At
          example: '2022-10-01T00:00:00Z'
        deletedAt:
          type: string
          description: Deleted At
          example: '2022-10-01T00:00:00Z'
        label:
          type: string
          description: Alias label
          example: CRM ID
        archivedAt:
          type: string
          description: Archived At
          example: '2022-10-01T00:00:00Z'

````