Contact

A contact is a representation of a recipient or beneficiary.

This endpoint finds an existing discoverable Wise profile and adds it to your recipient list. The recipient is found just by an identifier, without having to know their bank details. The contactId from the response can be used to create a transfer.

Request

POST /v2/profiles/{{profileId}}/contacts?isDirectIdentifierCreation=true

identifiertext

A Wise profile’s identifier. It can be a Wisetag, email or phone number.

targetCurrencytext

3 character currency code

Response

contactIdtext

contactId in the format of UUID

nametext

full name of the contact

Example Request - GBP Recipient
curl -X POST https://api.sandbox.transferwise.tech/v2/profiles/{{profileId}}/contacts?isDirectIdentifierCreation=true/ \
-H 'Authorization: Bearer <client credential token>' \
-H 'Content-type: application/json' \
-d '{
"identifier":"@JonathanP",
"targetCurrency":"EUR"
}'

Creating a transfer with a contact

Creating a transfer with a contact is similar to the standard flow:

  1. Create a Quote where the targetAccount field is replaced with "contactId": <contactId>
  2. Extract the targetAccount value from the Quote
  3. Create a Transfer