Profiles

Create a Profile

Creates a Profile with supplied attributes

post/v1/profiles

Request

  • Base URL: https://api.quiltt.io
  • URL: https://api.quiltt.io/v1/profiles
  • Auth: HTTP bearer

Request body

uuidstring uuid nullable

An optional UUID to assign to the newly created Profile. If left blank, a random UUID will be assigned.

emailstring email nullable

The email associated with the Profile.

This field can be used to power passwordless authentication in the Connector.

phonestring E.164 nullable

The phone number associated with the Profile, in E164 Format.

Currently, only phone numbers in Canada, the US, and US territories are supported.

This field can be used to power passwordless authentication in the Connector.

namestring nullable

A common name or nickname for the Profile.

dateOfBirthstring date nullable

A physical person's date of birth.

metadataobject nullable

Custom metadata about the Profile, stored in a 'key-value' format.

See the Custom Metadata guide for more information and examples.

Example request

{
  "uuid": "09099066-b03b-4719-b93a-4033eb95ab21",
  "email": "name@example.com",
  "phone": "+14155552671",
  "name": "Quiltty",
  "names": {
    "full": "Quiltty McQuilttface",
    "first": "Quiltty",
    "last": "McQuilttface"
  },
  "dateOfBirth": "1991-10-29",
  "address": {
    "line1": "1412 Main St",
    "line2": "Suite 100",
    "city": "Dallas",
    "region": "Texas",
    "regionCode": "TX",
    "postalCode": "75202",
    "countryCode": "USA",
    "country": "United States of America"
  },
  "metadata": {
    "firebaseId": "4Wz7x0QkPdNNzgRgjZ4iIzMKjXo2",
    "avatar": "https://www.gravatar.com/avatar/5658ffccee7f0ebfda2b226238b1eb6e",
    "favoriteColor": "Purple"
  }
}

Response

Created

idstring global_id-v1 required

The ID of the Profile.

uuidstring uuid required

The UUID of the Profile.

metadataobject nullable required

Custom metadata about the Profile, stored in a 'key-value' format.

See the Custom Metadata guide for more information and examples.

emailstring email nullable required

The email associated with the Profile.

This field can be used to power passwordless authentication in the Connector.

phonestring E.164 nullable required

The phone number associated with the Profile, in E164 Format.

Currently, only phone numbers in Canada, the US, and US territories are supported.

This field can be used to power passwordless authentication in the Connector.

namestring nullable required

A common name or nickname for the Profile.

dateOfBirthstring date nullable required

A physical person's date of birth.

atstring date-time required

The UTC date and time of the most recently known state of the Profile.

This typically represents the time when Profile was last updated or synced with an upstream provider.

createdAtstring date-time required

The UTC date and time when the Profile was created, in ISO 8601 format.

updatedAtstring date-time required

Example response

{
  "id": "p_1hyoxpVVFib1HngGwKAzIr",
  "uuid": "174ec567-2492-4498-a706-504a79437235",
  "metadata": {
    "firebaseId": "4Wz7x0QkPdNNzgRgjZ4iIzMKjXo2",
    "avatar": "https://www.gravatar.com/avatar/5658ffccee7f0ebfda2b226238b1eb6e",
    "favoriteColor": "Purple"
  },
  "email": "name@example.com",
  "phone": "+14155552671",
  "name": "Quiltty",
  "names": {
    "full": "Quiltty McQuilttface",
    "first": "Quiltty",
    "last": "McQuilttface"
  },
  "dateOfBirth": "1991-10-29",
  "address": {
    "line1": "1412 Main St",
    "line2": "Suite 100",
    "city": "Dallas",
    "region": "Texas",
    "regionCode": "TX",
    "postalCode": "75202",
    "countryCode": "USA",
    "country": "United States of America"
  },
  "at": "2026-01-22T14:15:22Z",
  "createdAt": "2025-09-12T23:55:59Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.