Create or update an activity. Existence is checked by sourceId and tenantId

🚧

Activities for GitHub, Discord, Slack, and Twitter

If you want to add data from any of the above integrations through the API, refer to Sending data to integrations for an outline of the data structure that we are expecting.

Existence of an activity

Existence is determined by sourceId, which is the ID of the activity in the platform, and tenantId (which corresponds to your workspace ID).

  • For example, if an activity in platform GitHub with sourceId 1234 already exists, the activity will be updated.
  • If an activity in platform GitHub with sourceId 4242 does not exist, the activity will be created.

Updates to an activity

Updates are performed with a deep merge, with preference to the new data-points.

Example

Merging two activities

{
  "id": "066ad862-a8bb-44bb-8d9b-437bba02bf35",
  "type": "message",
  "timestamp": "2022-05-17 18:16:39.879+00",
  "platform": "discord",
  "info": {},
  "crowdInfo": {
    "body": "Always red!",
    "channel": "random"
  },
  "isKeyAction": true,
  "score": 1,
  "sourceId": "976186506756644954",
  "createdAt": "2022-05-17 18:20:35.479+00",
  "updatedAt": "2022-05-17 18:20:35.601+00",
  "communityMemberId": "073d0f98-bee9-47f6-8b35-247023ca0bb2",
  "parentId": "",
  "tenantId": "ab1d6621-9d56-411a-92ad-cd24a2185cd7",
  "conversationId": null,
  "sourceParentId": ""
}
{
  "id": "066ad862-a8bb-44bb-8d9b-437bba02bf35",
  "type": "message",
  "timestamp": "2022-05-17 18:16:39.879+00",
  "platform": "discord",
  "info": {},
  "crowdInfo": {
    "body": "Always blue!",
    "channel": "random",
    "reactions": [
      {
        "emoji": "fire",
        "count": 42
      }
    ]
  },
  "isKeyAction": true,
  "score": 1,
  "sourceId": "976186506756644954",
  "createdAt": "2022-05-17 18:20:35.479+00",
  "updatedAt": "2022-05-17 18:20:35.601+00",
  "communityMemberId": "073d0f98-bee9-47f6-8b35-247023ca0bb2",
  "parentId": "",
  "tenantId": "ab1d6621-9d56-411a-92ad-cd24a2185cd7",
  "conversationId": null,
  "sourceParentId": ""
}
{
  "id": "066ad862-a8bb-44bb-8d9b-437bba02bf35",
  "type": "message",
  "timestamp": "2022-05-17 18:16:39.879+00",
  "platform": "discord",
  "info": {},
  "crowdInfo": {
    "body": "Always blue!",
    "channel": "random",
    "reactions": [
      {
        "emoji": "fire",
        "count": 42
      }
    ]
  },
  "isKeyAction": true,
  "score": 1,
  "sourceId": "976186506756644954",
  "createdAt": "2022-05-17 18:20:35.479+00",
  "updatedAt": "2022-05-17 18:20:35.601+00",
  "communityMemberId": "073d0f98-bee9-47f6-8b35-247023ca0bb2",
  "parentId": "",
  "tenantId": "ab1d6621-9d56-411a-92ad-cd24a2185cd7",
  "conversationId": null,
  "sourceParentId": ""
}
Language
Authentication
Bearer
Click Try It! to start a request and see the response here!