New Integration: Tally

Description

Add Tally integration to sync form submissions, form metadata, and response data into CORE.

Reference Implementations

Existing Integrations (use as templates)

• integrations/hubspot/ - Similar form/CRM data system
• integrations/linear/ - Project management integration
• integrations/slack/ - For reference

Required Files Structure

integrations/tally/
├── src/
│   ├── index.ts          # Main entry, OAuth spec
│   ├── schedule.ts       # Sync logic
│   ├── utils.ts          # Tally API utilities
│   ├── account-create.ts # OAuth setup
│   └── create-activity.ts # Activity formatting
├── package.json
├── tsup.config.ts
└── README.md

Tally API Integration

OAuth Setup

• Use OAuth 2.0 authorization
• The Tally API is currently in beta and available for free to all Tally users
• Base URL: https://api.tally.so
• Developer docs: https://developers.tally.so/

Key Endpoints

• POST /forms - Create a form
• GET /forms - List forms
• GET /forms/{formId} - Get form details
• GET /forms/{formId}/submissions - Get form submissions
• GET /forms/{formId}/fields - Get form fields
• DELETE /forms/{formId}/submissions/{submissionId} - Delete a submission

Events to Track

1. Form Submissions - New form responses, updated responses
2. Form Management - Form created, form updated, form published
3. Webhook Events - Real-time notifications for form submissions via JavaScript event listeners

Implementation Tasks

• Set up basic integration structure following integrations/github/src/index.ts pattern
• Implement OAuth 2.0 flow in account-create.ts
• Create API utilities in utils.ts for Tally API calls
• Implement sync logic in schedule.ts for form submissions and metadata
• Convert form events to CORE activity format
• Add error handling and rate limiting
• Create integration documentation
• Add to integrations/README.md

Technical Notes

• Tally API is in beta; monitor for breaking changes
• Each form block requires a unique UUID (use standard UUID library)
• Supports JavaScript event listeners for real-time form interaction events (Standard embed, Popup, Custom domain)
• API follows RESTful conventions with JSON responses

Resources

• Tally API for Developers
• Tally Developer Docs
• Tally Developer Resources
• Tally Integrations

Labels

enhancement, integration, new-feature

Start by comparing integrations/hubspot/, integrations/linear/, integrations/slack/, and integrations/github/src/index.ts. Review the Tally developer documentation and verify the OAuth and endpoint requirements before planning the files under integrations/tally/. Done means the listed integration files, sync and activity handling, error and rate-limit behavior, documentation, and integrations/README.md entry are complete.