act skill
✓ VerifiedManage CRM data including contacts, companies, leads, and opportunities in Act using Apideck's unified API.
- GitHub stars
- 5
- Files
- 2
- Last commit
- Nov 11, 2026
- License
- Apache-2.0
- Allowed tools
- —
What does the act skill do?
act manages CRM data including contacts, companies, leads, and opportunities in Act using Apideck's unified API.
Summary generated from the skill's SKILL.md.
About the act skill
Managing CRM data like contacts, companies, leads, and opportunities within Act is what this skill enables. It is designed for developers who need to read, write, or search through Act records using Apideck's unified CRM API. By loading this skill, an agent can interact with Act databases through a standardized method surface, producing structured data from your CRM activities, pipelines, and leads.
This integration works specifically with Act Premium Cloud or self-hosted Act Premium for Web. It relies on Apideck to manage complex tasks such as authentication, pagination, rate limiting, and retries. Because it uses a unified API, the logic used to manage Act can be ported to other CRM connectors like Salesforce or HubSpot simply by changing the serviceId. Note that Act Premium Desktop is not supported, and data changes must be identified via polling since webhooks are not available.
What an agent can do with it
- 1Retrieve CRM contact listsAn agent can pull a list of all existing contacts from an Act database.
- 2Synchronize sales leadsA developer can instruct an AI to sync leads directly into the Act CRM.
- 3Manage sales pipelinesUsers can use the skill to interact with and update their Act pipelines.
- 4Access unsupported endpoints via proxyIf a specific CRM function is not in the unified API, the agent can call the Act API directly through a proxy.
Written from the skill's SKILL.md. Every use case is checked against a quote from it.
How to install the act skill
Each command copies the skill folder into the client's skills directory. Restart the client or start a new session to load it.Install the act skill in Claude Code
~/.claude/skills/act/SKILL.md
$ npx degit apideck-libraries/api-skills/skills/act ~/.claude/skills/actInstall the act skill in Claude Code (project)
.claude/skills/act/SKILL.md
$ npx degit apideck-libraries/api-skills/skills/act .claude/skills/actInstall the act skill in Codex
~/.agents/skills/act/SKILL.md
$ npx degit apideck-libraries/api-skills/skills/act ~/.agents/skills/actInstall the act skill in Gemini CLI
~/.gemini/skills/act/SKILL.md
$ npx degit apideck-libraries/api-skills/skills/act ~/.gemini/skills/actInstall the act skill in Claude.ai
npx degit apideck-libraries/api-skills/skills/act act && zip -r act.zip act # claude.ai → Customize → Skills → + → Create skill → Upload a skill → act.zip
Automated checks
Ran Nov 16, 2026Full report →Passed our automated checks. That is not a security audit: read the scripts before you let an agent run them. How checks work
- Source repository linked and reachableapideck-libraries/api-skills/skills/act is public and reachablegithub.com/apideck-libraries/api-skills/tree/HEAD/skills/act ↗Pass
- Open source license (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Pass
- Commit or release in the last yearLast commit 2026-11-11github.com/apideck-libraries/api-skills/commits ↗Pass
- No download-and-run or credential theft in scriptsNo scripts in the skill folderPass
- No hidden instructions in SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/apideck-libraries/api-skills/blob/HEAD/skills/act ↗Pass
- Pre-approved tools are scopedNo pre-approved tools; the agent asks before using onegithub.com/apideck-libraries/api-skills/blob/HEAD/skills/act ↗Pass
- SKILL.md follows the Agent Skills formatValid name and description; says when to use it; 148 linesgithub.com/apideck-libraries/api-skills/blob/HEAD/skills/act ↗Pass
SKILL.md
View on GitHubAct (via Apideck)
Access Act through Apideck's CRM unified API — one of 21 CRM connectors that share the same method surface. Code you write here ports to Odoo, Salesforce, HubSpot and 17 other CRM connectors by changing a single serviceId string. Apideck handles auth, pagination, rate limiting, and retries so you don't write per-tenant Act plumbing.
Quick facts
- Apideck serviceId:
act - Unified API: CRM
- Auth type: oauth2
- Gotchas: page
- Homepage: https://act.com
At a glance
- Implementation difficulty: moderate — Custom Auth: Consumer Enters Their Own Act! Login
- Vendor partnership required: no (Act! Development Partner Program) — Joining (by emailing act.developers@act.com) gives complimentary licences, SDK support and a marketplace listing after approval.
- Apideck-managed credentials: not available — Each consumer connects with their own Act! login.
- Account type required: Act! Premium Cloud, or self-hosted Act! Premium for Web with the Web API installed.
- Consumer access level: An Act! user with API access permission.
- Sandbox: not available (signup) — Free Act! trial with no credit card; confirm the trial database exposes the Web API before building on it.
- Costs: Needs an Act! subscription licence for the consumer's database; no separate API charge is published.
- Rate limits: Per-minute limit on Act! Premium Cloud, reported in the X-RateLimit-Limit header; Act! publishes no number.
- Authentication: Password grant; no redirect or consent screen.
- Webhooks: No webhooks - data changes are only visible by polling the unified API.
Important to know:
- Act! Premium Desktop cannot connect: its API host is internal-only, so Desktop consumers must first move to Act! Premium Cloud or self-hosted Act! Premium for Web (IIS, a CA-signed certificate, external access). Act! Connect Link, the old Desktop bridge, retired 31 December 2024.
Facts synced from Apideck's connector metadata API —
GET /connector/connectors/act(overviewfield) is the live, authoritative version.
When to use this skill
Activate this skill when the user explicitly wants to work with Act — for example, "pull contacts in Act" or "sync leads in Act". This skill teaches the agent:
- Which Apideck unified API covers Act (CRM)
- The correct
serviceIdto pass on every call (act) - Act-specific auth and coverage caveats
For the full method surface (parameters, pagination, filtering), use your language SDK skill:
apideck-node,apideck-python,apideck-dotnet,apideck-java,apideck-go,apideck-php, orapideck-rest
For the raw OpenAPI spec:
Minimal example (TypeScript)
import { Apideck } from "@apideck/unify";
const apideck = new Apideck({
apiKey: process.env.APIDECK_API_KEY,
appId: process.env.APIDECK_APP_ID,
consumerId: "your-consumer-id",
});
// List contacts in Act
const { data } = await apideck.crm.contacts.list({
serviceId: "act",
});
Portable across 21 CRM connectors
The Apideck CRM unified API exposes the same methods for every connector in its catalog. Switching from Act to another CRM connector is a one-string change — no rewrite, no new SDK.
// Today — Act
await apideck.crm.contacts.list({ serviceId: "act" });
// Tomorrow — same code, different connector
await apideck.crm.contacts.list({ serviceId: "odoo" });
await apideck.crm.contacts.list({ serviceId: "salesforce" });
This is the compounding advantage of using Apideck over integrating Act directly: code against the unified CRM API once, gain access to every connector in it. New connectors Apideck adds become available to your app without code changes.
Authentication
- Type: OAuth 2.0
- Managed by: Apideck Vault — Apideck handles the full OAuth dance (authorization code flow, token exchange, refresh). Never ask the user for API keys or tokens directly.
- User setup: Users authorize via the Vault modal. Connection state progresses
available → added → authorized → callable. - Token refresh: automatic. Expired tokens are refreshed transparently on the next API call.
See apideck-best-practices for Vault setup, connection lifecycle, and handling re-auth flows.
Verifying coverage
Not every CRM operation is supported by every connector. Always verify before assuming a method works:
curl 'https://unify.apideck.com/connector/connectors/act' \
-H "Authorization: Bearer ${APIDECK_API_KEY}" \
-H "x-apideck-app-id: ${APIDECK_APP_ID}"
See apideck-connector-coverage for patterns around UnsupportedOperationError and connector-specific fallbacks.
Escape hatch: Proxy API
When an endpoint isn't covered by the CRM unified API, use Apideck's Proxy to call Act directly — Apideck injects auth headers and handles token refresh. Set x-apideck-downstream-url to the target endpoint on Act's own API:
curl 'https://unify.apideck.com/proxy' \
-H "Authorization: Bearer ${APIDECK_API_KEY}" \
-H "x-apideck-app-id: ${APIDECK_APP_ID}" \
-H "x-apideck-consumer-id: ${CONSUMER_ID}" \
-H "x-apideck-service-id: act" \
-H "x-apideck-downstream-url: <target endpoint on Act>" \
-H "x-apideck-downstream-method: GET"
See Act's API docs for available endpoints.
Sibling connectors
Other CRM connectors that share this unified API surface (same method signatures, just change serviceId):
odoo (beta), salesforce, hubspot, pipedrive, zoho-crm, activecampaign, close, microsoft-dynamics, and 12 more.
See also
- CRM OpenAPI spec · API Explorer
apideck-connector-coverage— programmatic coverage checksapideck-best-practices— architecture, Vault, pagination, error handlingapideck-node— TypeScript / Node SDK patterns
Files in this skill
2act skill questions
How do I install the act skill in Claude Code?
Run npx degit apideck-libraries/api-skills/skills/act ~/.claude/skills/act. Claude Code loads skills from ~/.claude/skills (all projects) or .claude/skills (one project) and uses a skill when its description matches the task.
Which clients can use the act skill?
Any client that reads the Agent Skills format: Claude Code, Codex, Gemini CLI and claude.ai (upload as a ZIP). Scripts in the skill run only where the client allows code execution.
Can I use Act Premium Desktop with this integration?
No, Act! Premium Desktop cannot connect because its API host is internal-only. You must use Act! Premium Cloud or self-hosted Act! Premium for Web.
Does this skill support webhooks for real-time data changes?
No, webhooks are not supported; you must use polling via the unified API to detect data changes.
How do I switch from Act to another CRM like Salesforce?
You can switch by simply changing the serviceId string in your API calls, as the method surface remains the same.