Skip to main content
POST
/
user
/
contacts
/
{userToken}
Create contact
curl --request POST \
  --url https://raas-partner-cv.nomas.cash/v1/user/contacts/{userToken} \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "firstName": "Hugo",
  "lastName": "Tru",
  "phone": "+19166014999",
  "email": "javier+1@leapfinancial.com",
  "countryCode": "US"
}
'
{
  "reason": "Contact created"
}

Authorizations

api_key
string
header
required

Path Parameters

userToken
string
required

Owner user token.

Body

application/json

Contact data to register.

POST /user/contacts/{userToken} body for partner create contact (owner resolved from path).

countryCode
string
required

Country code for phone normalization and display. ISO 3166-1 alpha-2. Example: US.

phone
string
required

Phone number with country code (E.164). Example: +19166020018.

lastName
string
required

Contact family name. Example: Tru.

firstName
string
required

Contact given name(s). Example: Hugo.

alias
string

Optional label shown in the address book.

email
string

Email address. Example: name@domain.com.

Response

200 — OK. Contact persisted.

Scenarios for this response:

ScenarioHow to reproduceTypical code / body
Contact createdValid token + body + unique phone.{ "reason": "Contact created", "code": "OK" }

See also Full scenario matrix.

code
string
required
reason
string
required