Portal Consumer Profiles

Manage the consumers and effective group assignments for a portal.

Portal Consumer Profiles object

Attributes

object

String

id

String

name

String

email

String

image_url

String

consumer_id

String

status

Enum

created_at

Date

updated_at

Date
{
  "object": "example_object",
  "id": "example_id",
  "name": "example_name",
  "email": "example_email",
  "image_url": "example_image_url",
  "consumer_id": "example_consumer_id",
  "status": "active",
  "created_at": "2026-05-22T18:43:37.156Z",
  "updated_at": "2026-05-22T18:43:37.156Z"
}

List portal consumer profiles

Returns a paginated list of consumer profiles for a portal.

URL Parameters

portal_id

String

The unique identifier for the portal

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional

search

StringOptional

consumer_group_id

StringOptional

status

UnionOptional
GEThttp://api.metorial.com/portals/:portal_id/consumer-profile
curl -X GET "https://api.metorial.com/portals/por_Rm4Mnheq2bfEPhBhP7SY/consumer-profile" \
  -H "Authorization: Bearer metorial_sk_..."

Get portal consumer profile

Retrieves a portal consumer profile by ID.

URL Parameters

portal_id

String

The unique identifier for the portal

consumer_profile_id

String

The unique identifier for the consumer_profile

GEThttp://api.metorial.com/portals/:portal_id/consumer-profile/:consumer_profile_id
curl -X GET "https://api.metorial.com/portals/por_Rm4Mnheq2bfEPhBhP7SY/consumer-profile/con_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."

Assign portal consumer profile groups

Assigns one or more groups to a portal consumer profile.

URL Parameters

portal_id

String

The unique identifier for the portal

consumer_profile_id

String

The unique identifier for the consumer_profile

Request Body

group_ids

Array of Strings
POSThttp://api.metorial.com/portals/:portal_id/consumer-profile/:consumer_profile_id/assign-groups
curl -X POST "https://api.metorial.com/portals/por_Rm4Mnheq2bfEPhBhP7SY/consumer-profile/con_Rm4Mnheq2bfEPhBhP7SY/assign-groups" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "group_ids": [
    "example_item"
  ]
}'

Unassign portal consumer profile groups

Removes one or more groups from a portal consumer profile.

URL Parameters

portal_id

String

The unique identifier for the portal

consumer_profile_id

String

The unique identifier for the consumer_profile

Request Body

group_ids

Array of Strings
POSThttp://api.metorial.com/portals/:portal_id/consumer-profile/:consumer_profile_id/unassign-groups
curl -X POST "https://api.metorial.com/portals/por_Rm4Mnheq2bfEPhBhP7SY/consumer-profile/con_Rm4Mnheq2bfEPhBhP7SY/unassign-groups" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "group_ids": [
    "example_item"
  ]
}'