Skip to main content
POST
/
api
/
public
/
apps
/
group
cURL
curl --request POST \
  --url http://localhost:3001/api/public/apps/group \
  --header 'Content-Type: application/json' \
  --header 'PublicWriteKey: <api-key>' \
  --header 'authorization: <authorization>' \
  --data '
{
  "messageId": "<string>",
  "groupId": "<string>",
  "userId": "<string>",
  "timestamp": "<string>",
  "assigned": true,
  "traits": {},
  "context": {}
}
'
{}

Authorizations

​
PublicWriteKey
string
header
required

Authorization header for the request, in the format Bearer <token>. Find your token at https://app.dittofeed.com/dashboard/settings#write-key.

Headers

​
authorization
string
required

Authorization header for the request, in the format Bearer <token>. Find your token at https://app.dittofeed.com/dashboard/settings#write-key.

Body

application/json
​
messageId
string
required

Unique identifier for the message, used as an idempotency key for safe retries. Can provide a UUID.

​
groupId
string
required
​
userId
string
required

Unique identifier for the user. Should be the id of the user in your system. Only applicable to logged in users.

​
timestamp
string

ISO 8601 formatted timestamp of when the event occurred. If not provided, the current server time will be used.

​
assigned
boolean
​
traits
object

Traits of the group.

​
context
object

Provides metadata about the user submitting the event and the context in which the event occurred.

Response

200

Default Response