---
title: "POST /addresses"
method: POST
path: "/addresses"
tags: ["Address"]
---

# POST /addresses

`POST /addresses`

Creates a new address for current user's organization

## Headers

- `Authorization` string, required

## Request body

- Address
  - `address1` string
  - `address2` string
  - `city` City
    - `areaCode` string
    - `cityCode` string
    - `countryCode` string
    - `name` string — Model
  - `cityCode` string
  - `cityName` string
  - `countryCode` string
  - `countryName` string
  - `createdAt` string
  - `district` District
    - `cityCode` string
    - `countryCode` string
    - `districtID` integer
    - `name` string — Model
  - `districtID` integer — DistrictID *common.DbUUID `json:"districtID" ts_type:"string" swaggertype:"string" format:"uuid4" `
  - `districtName` string
  - `email` string
  - `id` string, uuid4
  - `isActive` boolean
  - `isDefaultReturnAddress` boolean
  - `isDefaultSenderAddress` boolean
  - `isInvoiceAddress` boolean
  - `isRecipientAddress` boolean
  - `metadata` object
  - `name` string
  - `owner` string
  - `phone` string
  - `shortName` string
  - `source` string
  - `state` string
  - `streetID` string, uuid4
  - `streetName` string
  - `test` boolean
  - `updatedAt` string
  - `zip` string

## Response `201`

Created

- object
  - `additionalMessage` string
  - `code` string
  - `data` Address
    - `address1` string
    - `address2` string
    - `city` City
      - `areaCode` string
      - `cityCode` string
      - `countryCode` string
      - `name` string — Model
    - `cityCode` string
    - `cityName` string
    - `countryCode` string
    - `countryName` string
    - `createdAt` string
    - `district` District
      - `cityCode` string
      - `countryCode` string
      - `districtID` integer
      - `name` string — Model
    - `districtID` integer — DistrictID *common.DbUUID `json:"districtID" ts_type:"string" swaggertype:"string" format:"uuid4" `
    - `districtName` string
    - `email` string
    - `id` string, uuid4
    - `isActive` boolean
    - `isDefaultReturnAddress` boolean
    - `isDefaultSenderAddress` boolean
    - `isInvoiceAddress` boolean
    - `isRecipientAddress` boolean
    - `metadata` object
    - `name` string
    - `owner` string
    - `phone` string
    - `shortName` string
    - `source` string
    - `state` string
    - `streetID` string, uuid4
    - `streetName` string
    - `test` boolean
    - `updatedAt` string
    - `zip` string
  - `message` string
  - `result` boolean

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `500` — Internal Server Error

---

[API](https://skmtc.dev/geliver/apis/geliver-api.md) · [All operations](https://skmtc.dev/geliver/apis/geliver-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/geliver/geliver-api/revisions/b477e23b5716/schema)
