Profiles

Create profile (via /me)

Create a new profile. Supports both JWT and API key authentication.

post/api/v1/me/profiles

Request

Base URL: https://api.proof.holdings
URL: https://api.proof.holdings/api/v1/me/profiles
Auth: one of:
- API key in cookie auth_token
- HTTP bearer

Request body

display_namestring

biostring

avatar_urlstring

business_namestring

is_businessboolean

is_publicboolean

is_primaryboolean

email_theme'dark' | 'light'

Theme of the HTML emails sent for this project (sub-account). Unset reads as dark.

support_emailstring email

Support address shown in this project's messages as {{support_email}}.

Example request

{
  "display_name": "Jane Doe",
  "theme": {
    "primary_color": "#22c55e",
    "background_type": "solid",
    "background_color": "#0a0a0a",
    "font_style": "default"
  }
}

Response

Profile created

idstring required

MongoDB ObjectId

display_namestring

biostring

avatar_urlstring

business_namestring

is_businessboolean

is_publicboolean required

is_primaryboolean

usernamestring

show_delegationsboolean

The owner's switch for the public Delegations section (default true). Returned to the owner.

email_theme'dark' | 'light' | 'null' nullable

Theme of this project's emails; null when unset (read as dark). Returned to the owner.

support_emailstring nullable

Support address shown in this project's messages. Returned to the owner.

created_atstring date-time required

updated_atstring date-time required

Example response

{
  "id": "507f1f77bcf86cd799439011",
  "theme": {
    "primary_color": "#22c55e",
    "background_type": "solid",
    "background_color": "#0a0a0a",
    "font_style": "default"
  },
  "custom_links": [
    {
      "title": "Website",
      "url": "https://example.com",
      "is_visible": true
    }
  ],
  "proofs": [
    {
      "type": "phone",
      "channel": "whatsapp"
    }
  ],
  "delegations": [
    {
      "delegate": "pkg:npm/@proof-holdings/mcp-server",
      "principal": "proof.holdings",
      "scope": [
        "send-email"
      ],
      "artifact_path": "/npm/@proof-holdings/mcp-server"
    }
  ]
}

Changes

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