Profiles
Create and update team profiles through the API.
Profiles describe the company or brand behind a campaign or order. API-created profiles use the same core fields collected during onboarding.
Required scopes
| Action | Scope |
|---|---|
| Create a profile | profiles.create |
| Update a profile | profiles.update |
| List team profiles | profiles.lists |
Create profile body
Use this body for POST /profiles.
| Field | Type | Description |
|---|---|---|
name | string | Profile or company name |
website_url | string | Company website URL |
overview | string | Company overview or description |
products_and_services | string | Main products and services |
key_achievements | string[] | Notable achievements, awards, or milestones |
unique_value_propositions | string[] | Differentiators or value propositions |
industry | string[] | Industry tag UUIDs or custom industry names |
target_audience | string[] | Audience tag UUIDs or custom audience names |
Create a profile
curl -X POST "https://api.presscart.com/profiles" \
-H "Authorization: Bearer $PRESSCART_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Acme Corp",
"website_url": "https://acme.com",
"overview": "Acme helps finance teams automate invoice workflows.",
"products_and_services": "Invoice automation, payment reconciliation, and spend analytics.",
"key_achievements": ["Processed over $500M in invoices"],
"unique_value_propositions": ["Finance automation built for mid-market operators"],
"industry": ["Fintech", "B2B SaaS"],
"target_audience": ["CFOs", "Finance operations teams"]
}'Save the returned id; use it as profile_id when creating orders or campaigns.
Update a profile
PATCH /profiles/{profile_id} accepts any subset of the profile body fields. Omitted fields stay unchanged. Send an empty array, such as "industry": [], only when you want to clear that tag category.
curl -X PATCH "https://api.presscart.com/profiles/22222222-2222-2222-2222-222222222222" \
-H "Authorization: Bearer $PRESSCART_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"overview": "Acme helps finance teams automate invoice and payment workflows.",
"target_audience": ["CFOs", "Finance operations teams"]
}'The update endpoint only updates submitted fields. Submitted industry and target_audience arrays replace that tag category.