Notifications
Notification tools manage opportunity subscriptions (Slack alerts on stage changes) and agent API key lifecycle.
subscribe_opportunity
Watch an opportunity for stage changes. When the opportunity changes stage, a notification is sent to the team's Slack channel.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| opportunity_id | string (UUID) | Yes | Opportunity ID |
| user_id | string (UUID) | Yes | User ID to subscribe |
Example
json
{
"name": "subscribe_opportunity",
"arguments": {
"opportunity_id": "550e8400-e29b-41d4-a716-446655440000",
"user_id": "660e8400-e29b-41d4-a716-446655440000"
}
}unsubscribe_opportunity
Stop watching an opportunity for stage changes.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| opportunity_id | string (UUID) | Yes | Opportunity ID |
| user_id | string (UUID) | Yes | User ID to unsubscribe |
Example
json
{
"name": "unsubscribe_opportunity",
"arguments": {
"opportunity_id": "550e8400-e29b-41d4-a716-446655440000",
"user_id": "660e8400-e29b-41d4-a716-446655440000"
}
}list_subscriptions
List active opportunity watches for a user. Returns each subscription with the opportunity's current title and stage.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| user_id | string (UUID) | Yes | User ID |
Example
json
{
"name": "list_subscriptions",
"arguments": {
"user_id": "550e8400-e29b-41d4-a716-446655440000"
}
}create_agent_key
Generate a new API key for an agent. The raw key is returned once and cannot be retrieved again -- store it securely.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| user_id | string (UUID) | Yes | User who owns this key |
| name | string | Yes | Human label (e.g. "Claude Cowork - Desktop") |
| agent_type | string | Yes | claude_cowork, claude_code, openclaw, or other |
Example
json
{
"name": "create_agent_key",
"arguments": {
"user_id": "550e8400-e29b-41d4-a716-446655440000",
"name": "Claude Cowork - Desktop",
"agent_type": "claude_cowork"
}
}Response Shape
json
{
"id": "...",
"name": "Claude Cowork - Desktop",
"agent_type": "claude_cowork",
"created_at": "2026-04-07T14:00:00Z",
"api_key": "prt_abc123...",
"warning": "Store this key securely -- it cannot be retrieved again."
}list_agent_keys
List active (non-revoked) API keys for a user. The key hash is not returned -- only metadata.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| user_id | string (UUID) | Yes | User ID |
Example
json
{
"name": "list_agent_keys",
"arguments": {
"user_id": "550e8400-e29b-41d4-a716-446655440000"
}
}revoke_agent_key
Revoke an API key. The key will no longer authenticate requests.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string (UUID) | Yes | Agent key ID |
Example
json
{
"name": "revoke_agent_key",
"arguments": {
"id": "550e8400-e29b-41d4-a716-446655440000"
}
}