Skip to main content
Connect Hardal analytics data to Twenty CRM to automatically create and update contacts, track customer interactions, and manage your sales pipeline.
Make sure to check the partner’s website and API documentation for the most up-to-date information and configurations.
1

Get Twenty API Key

  1. Log in to your Twenty CRM instance
  2. Go to Settings > Developers > API Keys
  3. Create a new API key with appropriate permissions
  4. Copy the API key and your workspace URL
2

Configure Hardal Integration

In your Hardal dashboard:
  1. Navigate to Destinations > Add Destination
  2. Select Custom API
  3. Enter your Twenty API endpoint: https://your-workspace.twenty.com/rest
  4. Set request method to POST
3

Add Authentication

Add the API key to headers:
{
  "headers": {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  }
}
4

Set Contact Data Format

Configure contact creation payload:
{
  "query": "mutation CreatePerson($data: PersonCreateInput!) { createPerson(data: $data) { id name email } }",
  "variables": {
    "data": {
      "name": "##user.name##",
      "email": "##user.email##",
      "phone": "##user.phone##",
      "jobTitle": "##user.job_title##",
      "companyName": "##user.company##"
    }
  }
}
5

Configure Activity Tracking

Track user events as activities:
{
  "query": "mutation CreateActivity($data: ActivityCreateInput!) { createActivity(data: $data) { id title } }",
  "variables": {
    "data": {
      "title": "##event_name##",
      "body": "##properties##",
      "type": "NOTE",
      "personId": "##user_id##"
    }
  }
}

​
Available Data Mapping

  • Contact Information: Name, email, phone, company
  • User Events: Page views, purchases, form submissions
  • Custom Properties: User attributes and event data
  • Activity Timeline: Complete user interaction history