Amba

Activity Feeds

Auto-generated activity feeds from engagement events using feed rules.

Activity feeds show social activity within your app. Set up feed rules to automatically create feed items when users track specific events.

How it works

  1. Admin creates feed rules that map engagement events to feed actions
  2. When a user tracks a matching event, a feed item is created automatically
  3. Users can browse their feed to see friends' activity

Feed rules

A feed rule has:

  • source_event — the engagement event that triggers feed item creation
  • action — the action string in the feed item (e.g., "reached_streak_milestone")
  • target_type — optional target type for context

Example rule

When a user tracks streak_milestone, create a feed item with action reached_streak_milestone:

{
  "source_event": "streak_milestone",
  "action": "reached_streak_milestone",
  "target_type": "streak"
}

Client API reference

MethodPathDescription
GET/v1/client/feedsActivity from the user and their accepted friends
GET/v1/client/feeds/timelineThe same feed, under the SDK's default feed name
GET/v1/client/feeds/meThe user's own activity
GET/v1/client/feeds/group/:groupIdA group's activity

MCP tools

ToolDescription
amba_feeds_rules_createCreate a rule to auto-generate feed items from events

Example

Agent: "Set up feed items for achievements and streak milestones"

amba_feeds_rules_create({
  project_id: "proj_xxx",
  source_event: "achievement_unlocked",
  action: "unlocked_achievement"
})

amba_feeds_rules_create({
  project_id: "proj_xxx",
  source_event: "streak_milestone",
  action: "reached_streak_milestone",
  target_type: "streak"
})

On this page