Control access to Clay tables, enrichment credits, and integrations at the team level. Clay uses a workspace model where team members are assigned Admin, Member, or Viewer roles. This skill covers role assignment, credit budget allocation, API key isolation, and audit procedures.
Prerequisites
Clay Team or Enterprise plan
Workspace admin privileges
Understanding of team structure and data access needs
Instructions
Step 1: Define Role Matrix
Clay has three built-in roles with fixed permissions:
Capability
Admin
Member
Viewer
Manage workspace members
Yes
No
No
Manage billing and credits
Yes
No
No
Create/delete tables
Yes
Yes
No
Run enrichments
Yes
Yes
No
Configure integrations
Yes
No
No
Export data
Yes
Yes
Yes
View all tables
Yes
Yes
Yes
Recommended role assignments:
roles:
admin:
assign_to:
- Revenue Operations Lead
- GTM Engineering Lead
why: "Controls billing, integrations, and team access"
member:
assign_to:
- SDRs building prospect lists
- Growth engineers building pipelines
- Marketing ops running enrichment campaigns
why: "Can create tables and run enrichments but can't change billing or integrations"
viewer:
assign_to:
- Sales managers reviewing lead quality
- Executives checking pipeline metrics
- Finance reviewing credit usage
why: "Read-only access to enriched data and exports"
Step 2: Invite and Manage Team Members
In Clay UI: Settings > Members > Invite
Best practices:
Use company email addresses (not personal)
Start new members as Viewers until they complete Clay training
Audit member list quarterly -- remove departed employees immediately
Step 3: Isolate API Keys by Integration
Create separate API keys for each downstream system to enable independent revocation:
api_keys:
crm-sync-prod:
purpose: "HubSpot CRM sync from Clay"
used_by: "HTTP API column in Outbound Leads table"
rotation: quarterly
outbound-instantly:
purpose: "Push qualified leads to Instantly.ai"
used_by: "HTTP API column for outreach"
rotation: quarterly
internal-dashboard:
purpose: "Pull enrichment metrics for internal dashboard"
used_by: "Cron job reading Clay table stats"
rotation: quarterly
ci-testing:
purpose: "Integration tests in CI pipeline"
used_by: "GitHub Actions workflow"
rotation: on-demand
Step 4: Set Credit Budget Controls
Since Clay doesn't have per-user credit budgets natively, implement controls at the table level: