Marketing
Tally in your product and your AI agents, through one API
The Tally toolkit covers workspaces, forms, submissions and form analytics: list and read forms with their blocks, create and update them, read each submission with its responses, and get visits, completions, traffic sources and drop-off per question. The customer connects with a Tally API key, and your product or AI agent calls every operation through one Connect endpoint.
15 days to try it. No credit card.
POST https://connect.reportei.com/api/tools/tally_create_form/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"status": "BLANK",
"blocks": []
}
}How it works
From a connected customer to the first Tally call.
- 1
Your customer connects the account
Your system opens a Connect session for the toolkit and your customer connects their Tally account. You get the connection id.
- 2
Your product calls the tool
A POST to /api/tools/{tool}/execute with the connection id and arguments. On success, Connect preserves the app's response status and body.
- 3
Connect handles the rest
It stores the credential encrypted, renews tokens for OAuth connections that support renewal and records executions in an audit trail available through the API.
Use cases
What your product does with Tally.
Forms generated by your product
Create a Tally form from a list of blocks in the customer's workspace, and update its name, status or settings later.
Responses into your system
List the submissions of a form and map each response to its question by questionId, to feed a CRM, a database or a report.
Form performance by an agent
Let an agent read visits, completion rate and drop-off per question, and suggest which question to change.
Tools
12 Tally tools
- List workspacesGETLists the workspaces of the organization with id, name, members, pending invites and folders, each with id and name. Paginate with page while hasMore is true.
- List formsGETLists the forms with id, name, workspaceId, status, numberOfSubmissions, isClosed and dates. Paginate with page while hasMore is true.
- Get formGETReturns a form with its settings and every block, each with uuid, type, groupUuid, groupType and payload. Update form takes the blocks back in this format.
- Create formPOSTCreates a form from its blocks and returns its id, name, workspace and status. The form goes to the default workspace unless workspaceId is sent.
- Update formPATCHChanges the name, status, settings or blocks of a form. Sending blocks replaces all of them, so read the form with Get form first; name, status and settings can go alone.
- List form submissionsGETLists the submissions of a form, each with id, isCompleted, submittedAt, the preview and PDF links and its responses, plus the questions of the form, so each response maps to a question by questionId. Paginate with page while hasMore is true.
- Get form submissionGETReturns one submission with all its responses and the questions of the form.
- Get form metricsGETReturns the totals of a form in the period: visits, total views, starts, submissions, completions, unique respondents, completion rate and the average visit and completion durations.
- Get form visitsGETReturns the visits of a form over the period, as counts per interval.
- Get form submission analyticsGETReturns the completed and partial submissions of a form over the period, as counts per interval.
API key
Your customer pastes the app's key on a Connect screen, or your system sends the key with POST /api/customer-toolkits, with no screen.
Questions about the Tally toolkit
Do I need to build against the Tally API?
No. Connect ships 12 Tally tools, described and ready. Your customer connects the account and your system calls every tool through the same endpoint, with the same request format.
How does my customer connect their Tally account?
With the mode the toolkit accepts: API key. Connect stores the credential encrypted and never returns it to your system.
Does it work with AI agents?
Yes. Each tool's input is described in JSON Schema, which your agent uses directly as a tool definition. The agent picks the tool and the arguments, and your system makes the call to Connect.
Does my customer need a Reportei account?
No. Your customer connects the account on a Connect screen, or your system sends the credential through the API, and they keep using only your product.
Toolkits in the same category
See all 100 toolkitsSee Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
