fix(grain): updated grain trigger to auto-establish trigger

[aadamgough]

Summary

Updated trigger to follow new webhook documentation

Type of Change

• Bug fix

Testing

Tested manually

Checklist

• Code follows project style guidelines
• Self-reviewed my changes
• Tests added/updated and passing
• No new warnings introduced
• I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Review	Updated (UTC)
docs	Skipped		Jan 3, 2026 0:35am

[greptile-apps]

Greptile Summary

This PR migrates Grain webhook integration from manual configuration to automatic webhook management via the Grain API. The implementation follows the established pattern used by other providers like Calendly and Typeform.

Key Changes:

• Replaced manual webhook URL/secret inputs with API key authentication
• Added createGrainWebhookSubscription() function that programmatically creates webhooks in Grain using their Public API v2
• Added deleteGrainWebhook() function for proper cleanup when triggers are removed
• Integrated webhook creation/deletion into the main webhook lifecycle (after DB save, with rollback on failure)
• Added configurable include options (highlights, participants, AI summary) that are passed to Grain API
• Updated setup instructions to reflect automated webhook creation
• Uses API version 2025-10-31 header for all Grain API requests

Implementation Quality:

• Proper error handling with user-friendly messages for common failure scenarios (401, 403)
• Transaction-like behavior: rolls back DB changes if external webhook creation fails
• Non-fatal cleanup on deletion (won't fail if Grain API is unavailable)
• Consistent logging throughout the flow
• Follows existing codebase patterns for external webhook providers

Confidence Score: 5/5

• This PR is safe to merge with minimal risk
• The implementation closely follows the existing Calendly webhook pattern, includes proper error handling and rollback logic, maintains consistency across all 6 trigger files, and improves user experience by automating webhook setup
• No files require special attention

Important Files Changed

Filename	Overview
apps/sim/app/api/webhooks/route.ts	Added Grain webhook creation logic with proper error handling and rollback, following the pattern of other providers like Calendly
apps/sim/lib/webhooks/provider-subscriptions.ts	Added Grain webhook deletion handler with non-fatal error handling, consistent with other provider cleanup functions
apps/sim/triggers/grain/webhook.ts	Updated generic webhook trigger to use API key instead of manual webhook URL, added include options

Sequence Diagram

sequenceDiagram
    participant User
    participant UI as Trigger UI
    participant API as Webhook API
    participant DB as Database
    participant Grain as Grain API
    
    User->>UI: Configure Grain trigger with API key
    UI->>API: POST /api/webhooks (with apiKey, include options)
    API->>DB: Save webhook record
    DB-->>API: Return savedWebhook
    
    alt provider === 'grain'
        API->>API: createGrainWebhookSubscription()
        API->>Grain: POST /v2/hooks/create
        Note over API,Grain: Authorization: Bearer {apiKey}<br/>Body: {hook_url, include: {...}}
        
        alt Success
            Grain-->>API: {id: grainHookId}
            API->>DB: Update webhook with externalId
            DB-->>API: Webhook updated
            API-->>UI: 201 Created {webhook}
        else API Error (401, 403, etc)
            Grain-->>API: Error response
            API->>DB: DELETE webhook (rollback)
            API-->>UI: 500 Error with user-friendly message
        end
    end
    
    UI-->>User: Show success or error
    
    Note over User,Grain: When user deletes trigger
    User->>API: DELETE /api/webhooks/{id}
    API->>API: cleanupExternalWebhook()
    API->>API: deleteGrainWebhook()
    API->>Grain: DELETE /v2/hooks/{externalId}
    Grain-->>API: 200 OK or 404 Not Found
    API->>DB: Delete webhook record
    API-->>User: Webhook deleted

Loading