Webhook Integration

What Are Webhooks?

Webhooks let you receive real-time HTTP notifications when events happen in your workspace — like a contact being created, a deal changing stage, or an activity being completed.

Instead of polling the API for changes, webhooks push events to your server as they happen.

Planned Events

Planned Payload Format

{
  "id": "evt_abc123",
  "type": "deal.updated",
  "created_at": "2026-03-15T10:30:00Z",
  "workspace_id": "ws_abc123",
  "data": {
    "id": "dl_abc123",
    "type": "deal",
    "attributes": {
      "title": "Acme Corp License",
      "stage_id": "ps_won",
      "closed_at": "2026-03-15T10:30:00Z"
    }
  },
  "previous_attributes": {
    "stage_id": "ps_negotiation",
    "closed_at": null
  }
}

Polling as an Alternative

Until webhooks are available, you can poll for changes using the sort and cursor parameters:

# Get recently updated contacts
curl "https://api.nodestash.io/v1/contacts?sort=-updated_at&limit=50" \
  -H "Authorization: Bearer $NODESTASH_API_KEY"

// Poll for recently updated contacts
const { data: recentlyUpdated } = await client.contacts.list({
  sort: '-updated_at',
  limit: 50,
})

// Process contacts updated since your last sync
for (const contact of recentlyUpdated) {
  if (new Date(contact.updated_at) > lastSyncTime) {
    // Handle the update
  }
}

Stay Updated

Webhooks are a high-priority feature on our roadmap. In the meantime:

• Use polling with -updated_at sorting to detect changes
• Watch our changelog at nodestash.io/changelog
• Join our community on Discord for updates