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

# Create customer address

> Crea una dirección reutilizable para el customer.



## OpenAPI

````yaml post /ordering/customers/{externalCustomerId}/addresses
openapi: 3.1.0
info:
  title: Justo API
  version: 3.0.0
servers:
  - url: https://api.service.getjusto.com/v3
    description: Production server
security: []
paths:
  /ordering/customers/{externalCustomerId}/addresses:
    post:
      tags:
        - Ordering API
      summary: Create customer address
      description: Crea una dirección reutilizable para el customer.
      operationId: orderingCreateCustomerAddress
      parameters:
        - in: path
          name: externalCustomerId
          required: true
          description: ID del customer en el sistema externo. Es independiente por app.
          schema:
            type: string
      requestBody:
        description: Dirección a crear.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OrderingAddressInput'
      responses:
        '200':
          description: Create customer address
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  data:
                    $ref: '#/components/schemas/OrderingAddress'
                required:
                  - success
                  - data
        '400':
          description: Invalid request
        '401':
          description: Invalid bearer token
        '404':
          description: Resource not found
      security:
        - bearerAuth: []
components:
  schemas:
    OrderingAddressInput:
      type: object
      description: >-
        Dirección provista por la app externa. Ordering API la resuelve
        internamente a placeId y cityId.
      properties:
        streetAddress:
          type: string
          description: Calle y numeración ingresada por el customer o sistema externo.
        countryCode:
          type: string
          description: Código de país ISO 3166-1 alpha-2.
          example: CL
        extendedAddress:
          oneOf:
            - type: string
              description: Departamento, oficina u otra información secundaria.
            - type: 'null'
          description: Departamento, oficina u otra información secundaria.
        location:
          oneOf:
            - $ref: '#/components/schemas/OrderingLocation'
            - type: 'null'
        acceptsNoLine2:
          oneOf:
            - type: boolean
              description: Indica si el customer confirmó que no tiene línea 2.
            - type: 'null'
          description: Indica si el customer confirmó que no tiene línea 2.
        comment:
          oneOf:
            - type: string
              description: Comentario o instrucciones de entrega.
            - type: 'null'
          description: Comentario o instrucciones de entrega.
        locality:
          oneOf:
            - type: string
              description: Localidad o comuna.
            - type: 'null'
          description: Localidad o comuna.
        region:
          oneOf:
            - type: string
              description: Región o estado.
            - type: 'null'
          description: Región o estado.
        postalCode:
          oneOf:
            - type: string
              description: Código postal.
            - type: 'null'
          description: Código postal.
      additionalProperties: true
      required:
        - streetAddress
        - countryCode
    OrderingAddress:
      type: object
      description: Dirección guardada por el customer de Ordering API.
      properties:
        placeId:
          type: string
          description: Place ID usado por Justo para calcular cobertura y despacho.
        cityId:
          oneOf:
            - type: string
              description: ID de la ciudad marketplace resuelta para la dirección.
            - type: 'null'
          description: ID de la ciudad marketplace resuelta para la dirección.
        address:
          type: string
          description: Dirección principal.
        extendedAddress:
          oneOf:
            - type: string
              description: Departamento, oficina u otra información secundaria.
            - type: 'null'
          description: Departamento, oficina u otra información secundaria.
        addressLine2:
          oneOf:
            - type: string
              description: Alias legacy de extendedAddress.
            - type: 'null'
          description: Alias legacy de extendedAddress.
        addressSecondary:
          oneOf:
            - type: string
              description: Texto secundario de comuna, ciudad o referencia.
            - type: 'null'
          description: Texto secundario de comuna, ciudad o referencia.
        location:
          $ref: '#/components/schemas/OrderingLocation'
        acceptsNoLine2:
          type: boolean
          description: Indica si el customer confirmó que no tiene línea 2.
        comment:
          oneOf:
            - type: string
              description: Comentario o instrucciones de entrega.
            - type: 'null'
          description: Comentario o instrucciones de entrega.
        streetAddress:
          oneOf:
            - type: string
              description: Calle y numeración normalizada.
            - type: 'null'
          description: Calle y numeración normalizada.
        locality:
          oneOf:
            - type: string
              description: Localidad o comuna.
            - type: 'null'
          description: Localidad o comuna.
        subLocality:
          oneOf:
            - type: string
              description: Sub-localidad.
            - type: 'null'
          description: Sub-localidad.
        region:
          oneOf:
            - type: string
              description: Región o estado.
            - type: 'null'
          description: Región o estado.
        postalCode:
          oneOf:
            - type: string
              description: Código postal.
            - type: 'null'
          description: Código postal.
        countryCode:
          oneOf:
            - type: string
              description: Código de país ISO 3166-1 alpha-2.
              example: CL
            - type: 'null'
          description: Código de país ISO 3166-1 alpha-2.
        countryName:
          oneOf:
            - type: string
              description: Nombre del país.
            - type: 'null'
          description: Nombre del país.
        createdAt:
          type: string
          format: date-time
          description: Fecha de creación.
          example: '2026-06-01T12:00:00.000Z'
      additionalProperties: true
    OrderingLocation:
      type: object
      description: Coordenadas geográficas.
      properties:
        lat:
          type: number
          description: Latitud.
          example: -33.43219757080078
        lng:
          type: number
          description: Longitud.
          example: -70.59982299804688
      additionalProperties: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT Token

````