Create or get User Address

POST

/v3/user-address/

Crea o obtiene un contacto (User Address) para la company.

Si ya existe un contacto con el mismo uuid (CUIT/CUIL) para la company, lo retorna sin modificarlo.
Si no existe, lo crea con los datos proporcionados.

Body Parameters

Campo	Tipo	Requerido	Descripcion
`uuid`	string	Si	Identificador unico del contacto (CUIT/CUIL sin guiones)
`name`	string	No	Nombre o razon social del contacto
`email`	string	No	Email del contacto
`phone`	string	No	Telefono del contacto
`tags`	array	No	Etiquetas: `SUPPLIER`, `EMPLOYEE`, etc.
`displayName`	string	No	Nombre para mostrar (alias)

Respuesta

Retorna el contacto con sus datos completos, incluyendo addresses asociadas.

{
  "id": 1,
  "name": "Proveedor SA",
  "uuid": "30123456789",
  "addresses": [...],
  "email": "contacto@proveedor.com",
  "phone": "+5491112345678"
}

Request

Body Params application/json

Examples

Responses

🟢200

application/json

Successful response

Body

🟠401

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.develop.cresium.app/v3/user-address/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "addressId": 0,
    "uuid": "string",
    "email": "string",
    "phone": "string",
    "phoneCountryCode": "AR",
    "name": "string",
    "tags": [
        "PROVIDER"
    ],
    "displayName": "string"
}'

Response Example

200 - Example 1

{
    "data": {
        "id": 0,
        "name": "string",
        "uuid": "string",
        "description": "string",
        "ranking": 0,
        "addresses": [
            {
                "id": 0,
                "type": "CVU",
                "value": "string",
                "bankName": "string",
                "ownerName": "string",
                "img": "string",
                "uuid": "string",
                "displayName": "string"
            }
        ],
        "email": "string",
        "phone": "string",
        "defaultAddressId": 0,
        "defaultAddress": {
            "id": 0,
            "type": "CVU",
            "value": "string",
            "bankName": "string",
            "ownerName": "string",
            "img": "string",
            "uuid": "string",
            "displayName": "string"
        },
        "companyIntegration": {
            "id": 0,
            "companyId": 0,
            "key": "KONVEX",
            "enabled": true,
            "url": "string",
            "metadata": null,
            "img": "string",
            "name": "string",
            "lastSync": "string"
        },
        "tags": [
            "PROVIDER"
        ],
        "displayName": "string"
    }
}

Modified at 2026-03-16 21:37:55

Search partner transactions

V3 - Balance

Create or get User Address

Body Parameters#

Respuesta#

Request

Responses

Body Parameters

Respuesta