Quickstart

Get your first behavioral interaction logged in under 5 minutes.

NOTE

For MCP clients (Claude Desktop, Cursor or others), see the MCP Quickstart instead.

1. Get Your API Key

1. Sign in at fusemomo.com
2. Navigate to Dashboard → API Keys → Create Key
3. Copy the key. It starts with fm_live_ api keys.

Set it as an environment variable in your shell or app config:

export FUSEMOMO_API_KEY="fm_live_xxxxxxxxxxxxxxxxxxxx"

WARNING

Never embed your API key in client-side code. Use environment variables or a secrets manager.

2. Resolve an Entity

Call resolve_entity first in every workflow. This returns (or creates) a canonical entity from any known identifiers and gives you the entity_id that all subsequent calls require.

curl -X POST https://api.fusemomo.com/v1/core/entities/resolve \
  -H "Authorization: Bearer $FUSEMOMO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "identifiers": {
      "client_id": "ibergx9H50",
      "email": "[EMAIL_ADDRESS]"
    },
    "entity_type": "contact"
  }'

Response:

{
  "entity_id": "ent_550e8400-e29b-41d4-a716-446655440000",
  "display_name": "[EMAIL_ADDRESS]",
  "entity_type": "contact",
  "...": "...",
}

Save the entity_id. You'll use it for everything else.

3. Log an Interaction

After your agent takes an action on this entity, record the outcome:

curl -X POST https://api.fusemomo.com/v1/core/interactions/log \
  -H "Authorization: Bearer $FUSEMOMO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "entity_id": "ent_550e8400-e29b-41d4-a716-446655440000",
    "agent_id": "my-agent-v1",
    "api": "github",
    "action_type": "assign_reviewer",
    "action": "Assigned PR #42 for review",
    "outcome": "success"
  }'

Response:

{
  "interaction_id": "int_3A21F5...",
  "entity_id": "ent_550e...",
  "logged_at": "2026-04-03T00:00:00Z"
}

4. Get a Recommendation (Builder+)

Once you have enough interaction history, you can ask Fusemomo what action is most likely to succeed:

curl -X POST https://api.fusemomo.com/v1/core/entities/ent_550e8400-e29b-41d4-a716-446655440000/recommend \
  -H "Authorization: Bearer $FUSEMOMO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "intent": "code_review" }'

Response:

{
  "recommendation_id": "rec_01A2B3C",
  "data_sufficient": true,
  "confidence_score": 0.87,
  "primary": {
    "api": "github",
    "action_type": "assign_reviewer",
    "raw_success_rate": 0.87
  }
}

Next Steps

• Core Concepts — Understand how identity resolution and the behavioral graph work
• API Reference — Full endpoint documentation
• MCP Integration — Use Fusemomo directly in Claude or Cursor