> ## 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.latest.product.live POST /customer-aliases
openapi: 3.0.0
info:
  title: ''
  description: ''
  version: 0.0.1
servers:
  - url: https://dev.seqhq.io
    description: E2E
  - url: https://dev.seqhq.io
    description: DEV
  - url: https://sandbox.sequencehq.com
    description: SANDBOX
  - url: https://eu.sequencehq.com
    description: PRODUCTION
security: []
tags:
  - name: Contacts
  - name: Customers
  - name: Organizations
  - name: Customer Aliases
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'
        - name: Idempotency-Key
          in: header
          description: >-
            A unique key that makes this request safe to retry (maximum 255
            characters). Retrying with the same key returns the original
            response, and the operation runs at most once. Keys are retained for
            24 hours; after that, a request with the same key is treated as new.
          required: false
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateCustomerAliasRequestModel'
              example:
                customerId: 01849e70-703e-705a-b59a-d3fd575587e0
                value: external-customer-alias-123
                label: CRM ID
            examples:
              CreateCustomerAliasRequestModel:
                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:
    CreateCustomerAliasRequestModel:
      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'

````