API

Contact

A contact, created from an identifier.

Operations

Every route this entity exposes. Each route links to its own reference on this page.

Method Route SDK operation Returns
POST /profiles/{profileId}/contacts create Contact created successfully

Examples

One example per SDK, generated from the API model. The argument names are the parameters and fields of this entity, and the values are placeholders. The examples are not compiled or executed.

Golang

Construct client as shown in the Golang setup, then call the operations:

created, err := client.Contact(nil).Create(map[string]any{"profile_id": 1, "is_direct_identifier_creation": true}, nil)
if err != nil {
    panic(err)
}
fmt.Println(created)

Lua

Construct client as shown in the Lua setup, then call the operations:

local created, err = client:Contact():create({ profile_id = 1, is_direct_identifier_creation = true })

PHP

Construct client as shown in the PHP setup, then call the operations:

$created = $client->Contact()->create(["profile_id" => 1, "is_direct_identifier_creation" => true]);

Python

Construct client as shown in the Python setup, then call the operations:

created = client.Contact().create({ "profile_id": 1, "is_direct_identifier_creation": True })

Ruby

Construct client as shown in the Ruby setup, then call the operations:

created = client.Contact.create({ "profile_id" => 1, "is_direct_identifier_creation" => true })

TypeScript

Construct client as shown in the TypeScript setup, then call the operations:

const created = await client.Contact().create({ profile_id: 1, is_direct_identifier_creation: true })

Fields

Field Type Required Description
contactId string No Contact ID in the format of UUID.
identifier string No A Wise profile's identifier.
name string No Full name of the contact.
targetCurrency string No 3 character currency code.

create

POST /profiles/{profileId}/contacts

Operation ID: contactCreate.

Authentication: bearer token (ClientCredentialsToken).

Parameters

Parameter In Type Required Description
profileId path integer (int64) Yes Your profile ID.
isDirectIdentifierCreation query boolean Yes Must be set to true for identifier-based contact creation.
X-External-Correlation-Id header string (uuid) No Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. Learn more.

Request body

application/json

Property Type Required Description
identifier string No A Wise profile's identifier. It can be a Wisetag, email or phone number.
targetCurrency string No 3 character currency code.

Example request body:

{
  "identifier": "@JonathanP",
  "targetCurrency": "EUR"
}

Responses

200: Contact created successfully

application/json

Property Type Required Description
contactId string (uuid) No Contact ID in the format of UUID.
name string No Full name of the contact.

Example response:

{
  "contactId": "00000000-0000-0000-0000-000000000000",
  "name": "Jonathan Peters"
}
429: Rate limit exceeded. Retry after the number of seconds specified in the Retry-After header

application/json

The response is object.