v5

latestOpenAPI 3.1.02026-07-262421791.5 MB
contact

Create a contact from an identifier

Finds an existing discoverable Wise profile and adds it to your recipient list. The recipient is found by an identifier — such as a Wisetag, email, or phone number — without needing bank details. Use the contactId from the response to create a transfer.

post/v2/profiles/{profileId}/contacts

Path parameters

profileIdinteger required

Your profile ID.

Query parameters

isDirectIdentifierCreationboolean required

Must be set to true for identifier-based contact creation.

Headers

X-External-Correlation-Idstring uuid

Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. Learn more.

Request body

identifierstring

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

targetCurrencystring

3 character currency code.

Response

Contact created successfully.

contactIdstring uuid

Contact ID in the format of UUID.

namestring

Full name of the contact.