Create and link an account - Bilt Rewards Support

{
  "contact": {
    "value": "jordan@example.com",
    "type": "email",
    "isVerified": true
  },
  "account": {
    "firstName": "Jordan",
    "lastName": "Lee",
    "email": "jordan@example.com",
    "phone": "+14155552671"
  },
  "biltMemberId": "550e8400-e29b-41d4-a716-446655440000",
  "idempotencyKey": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
}

{
  "status": "created_and_linked",
  "partnerMemberId": "PARTNER123456789"
}

{
  "error": "<string>",
  "error_description": "<string>"
}

{
  "error": "invalid_token",
  "error_description": "The access token is invalid"
}

{
  "error": "<string>",
  "error_description": "<string>"
}

{
  "error": "account_exists",
  "error_description": "An account already exists for this contact"
}

{
  "error": "<string>",
  "error_description": "<string>"
}

{
  "error": "<string>",
  "error_description": "<string>"
}

{
  "error": "<string>",
  "error_description": "<string>"
}

Implement POST /bilt/create-and-link-account on your server. Bilt calls it with the request below.

Authorizations

Authorization

string

header

required

The credential you issue to Bilt for the endpoints you host. Validate it on every request, before you read the body, and keep it out of logs.

Body

application/json

contact

object

required

Show child attributes

account

object

required

Taken from Bilt's member records, never typed by the member. Bilt does not call you when any field is missing. If you accept phone numbers from some countries only, agree that during onboarding; Bilt checks the number before calling you.

Show child attributes

biltMemberId

string<uuid>

required

idempotencyKey

string<uuid>

required

Unique per link request, and the same linkId as on link account.

Response

The account was created and linked.

status

string

required

Allowed value: "created_and_linked"

partnerMemberId

string

required

⌘I

{
  "contact": {
    "value": "jordan@example.com",
    "type": "email",
    "isVerified": true
  },
  "account": {
    "firstName": "Jordan",
    "lastName": "Lee",
    "email": "jordan@example.com",
    "phone": "+14155552671"
  },
  "biltMemberId": "550e8400-e29b-41d4-a716-446655440000",
  "idempotencyKey": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
}

{
  "status": "created_and_linked",
  "partnerMemberId": "PARTNER123456789"
}

{
  "error": "<string>",
  "error_description": "<string>"
}

{
  "error": "invalid_token",
  "error_description": "The access token is invalid"
}

{
  "error": "<string>",
  "error_description": "<string>"
}

{
  "error": "account_exists",
  "error_description": "An account already exists for this contact"
}

{
  "error": "<string>",
  "error_description": "<string>"
}

{
  "error": "<string>",
  "error_description": "<string>"
}

{
  "error": "<string>",
  "error_description": "<string>"
}