SupportGithubFeedbackNalpeiron UniversityFree Trial

Native Integration Details

License management and entitlement tracking automation

https://zapier.com/apps/zengain-by-Nalpeiron/integrations

Zengain by Nalpeiron

Customer insights and engagement automation.

  • Webhook triggers for customer events

  • Search actions for customer data

  • Best for: Customer engagement, insight-driven workflows, CRM integration

Getting Started

Prerequisites

  • Active Zapier account (sign up)

  • Zentitle2 or Zengain account with API access

  • API credentials: Client ID, Client Secret, Tenant ID, OAuth Token URL, Base API URL:

https://docs.nalpeiron.com/zentitle2-docs/ui-administration/api-credentials

Connecting Your Account

  1. In Zapier, create a new Zap and search for Zentitle2 by Nalpeiron or Zengain by Nalpeiron

  2. Click Sign in when prompted

  3. Enter your credentials:

    • Client ID

    • Client Secret

    • Tenant ID: Your organization identifier

    • OAuth Token URL: https://[domain]/realms/[tenant-id]/protocol/openid-connect/token

    • Base API URL: https://[domain] (no trailing slash)

  4. Click Yes, Continue

Zentitle2 by Nalpeiron:

Zengain by Nalpeiron:

Using Triggers

Triggers start your Zap when events occur in Zentitle2 by Nalpeiron or Zengain by Nalpeiron. All triggers use webhooks for instant, real-time notifications.

How It Works

  1. Turn on your Zap → Zapier registers a webhook

  2. Event occurs in Zentitle2/Zengain → System sends data instantly

  3. Your Zap runs with the event data

Key Zentitle2 Triggers

Customer Events:

  • New Customer (customer.created) - Triggers when a new customer is created.

  • Updated Customer (customer.updated) - Triggers when a customer is updated.

Entitlement Events:

  • New Entitlement (entitlement.created) - Triggers when a new entitlement is created.

  • Activated Entitlement (entitlement.activated) - Triggers when an entitlement is activated.

  • Expired Entitlement (entitlement.expired) - Triggers when an entitlement expires.

  • Entitlement Expires in 1/7/30 Days - Proactive expiration warnings

  • Entitlement Seat Activated/Deactivated - Seat usage tracking

Maintenance Events:

  • Entitlement Maintenance Expired - Maintenance period ends

  • Entitlement Maintenance Expires in 1/7/30 Days - Maintenance warnings

Group Events:

  • New Entitlement Group (entitlement.group.created) - Triggers when a new entitlement group is created.

  • Updated Entitlement Group (entitlement.group.updated) - Triggers when an entitlement group is updated.

See full list in Reference section

Zentitle2:

Key Zengain Triggers

  • New Customer (customer.created) - Triggers when a new customer is created.

  • Updated Customer (customer.updated) - Triggers when a customer is updated.

Zengain:

Setting Up a Trigger

  1. Select your trigger event and click Continue

  2. Connect your account

  3. Click the Test trigger to load sample data

  4. Use trigger fields in later steps by clicking the field → selecting data

Note: If no recent data exists, Zapier uses static samples. Your Zap will work with real events once turned on.

Zentitle2:

Zengain:

Using Searches

Searches retrieve specific records using IDs. Use them to enrich trigger data or look up information.

Key Zentitle2 Searches

Customer Searches:

  • Get Customers - List all customers (paginated)

  • Find Customer - customerId → Complete customer details

  • Find Customer Stats - customerId → Customer statistics

Entitlement Searches:

  • Get Entitlements - List all entitlements (paginated)

  • Find Entitlement - entitlementId → License details

  • Find Entitlement Activations - entitlementId → Activation records

  • Get Entitlement Groups - List all groups (paginated)

  • Find Entitlement Group - entitlementGroupId → Group details

Product Searches:

  • Get Products - List all products (paginated)

  • Find Product - productId → Product details

  • Find Product Editions - productId → List editions

  • Find Product Edition - productId, editionId → Edition details

  • Get Features - List all features (paginated)

  • Find Feature - featureId → Feature definition

See the full list in the Reference section

Zentitle2:

Key Zengain Searches

  • Get Customers - List all customers (paginated)

  • Find Customer - customerId → Customer profile

Screenshot Zengain:

Setting Up a Search

Add action step → Select Zentitle2 by Nalpeiron or Zengain by Nalpeiron

Use the folllowing steps:

  1. Choose search action (e.g., Find Customer)

  2. Fill required fields:

    • Manual entry: Type ID directly

    • Map from step: Click field → select from previous step

  3. Click the Test action to verify

Zentitle2 flow:

  • Step one.

  • Step two.

  • Step three.

Zengain flow:

  • Step One:

  • Step Two:

  • Step Three:

Note: Dynamic dropdowns are not available. All IDs require manual entry or mapping.

Common Workflow Examples

New Customer Onboarding

Trigger: Zentitle2 by Nalpeiron - New Customer

  1. Zentitle2 by Nalpeiron - Find Customer (get complete details)

  2. Gmail - Send welcome email

  3. Salesforce - Create account

License Expiration Alerts

Trigger: Zentitle2 by Nalpeiron - Entitlement Expires in 30 Days

  1. Zentitle2 by Nalpeiron - Find Entitlement (get license details)

  2. Zentitle2 by Nalpeiron - Find Customer (get contact info)

  3. Email - Send renewal reminder

  4. Asana - Create follow-up task

Seat Activation Monitoring

Trigger: Zentitle2 by Nalpeiron - Entitlement Seat Activated

  1. Google Sheets - Log activation

  2. Filter - Only continue if isOverdraftSeat = true

  3. Slack - Send overdraft alert

Troubleshooting

Authentication Issues

"Invalid client credentials"

  • Verify Client ID and Secret from Settings > API

  • Check for extra spaces

  • Ensure correct environment (test vs production)

"Failed to obtain access token"

  • Verify OAuth Token URL format: https://[domain]/realms/[tenant]/protocol/openid-connect/token

  • Check Base API URL matches domain

  • Ensure endpoint is publicly accessible

Trigger Issues

"No sample data available"

  • Expected when no recent events exist

  • Continue setup with static samples

  • Real events will trigger once Zap is ON

"Webhook not firing"

  1. Verify Zap is ON (green toggle)

  2. Check webhook registered in product Settings > Webhooks

  3. Test with fresh event

  4. Turn OFF → wait 10s → turn ON (re-registers webhook)

"Missing fields in output"

  • Click "Refresh fields" in action step

  • Retest trigger

  • Use custom field path if needed: payload__customerId

Search Issues

"Resource not found"

  • Verify exact ID (case-sensitive, no spaces)

  • Ensure resource exists in product

  • Check correct ID type (customer vs contact vs entitlement)

  • Verify API permissions

"Search with multiple fields fails"

  • Some searches need compound keys (e.g., Find Product Edition needs both productId AND editionId)

  • Ensure all required fields have valid values

Performance Issues

"Zap is slow to trigger"

  • Check status.zapier.com for incidents

  • Webhook triggers should be near-instant

  • Fix any previous Zap errors that may delay execution

"Zap turned itself off"

  • Zapier auto-disables after repeated errors

  • Check Zap History for error pattern

  • Fix the issue and turn Zap back ON

Reference

All Zentitle2 Triggers

Trigger Name

Event Code

New Customer

customer.created

Updated Customer

customer.updated

Activated Entitlement

entitlement.activated

New Entitlement

entitlement.created

Expired Entitlement

entitlement.expired

Entitlement Expires in 1 Day

entitlement.expires1day

Entitlement Expires in 30 Days

entitlement.expires30days

Entitlement Expires in 7 Days

entitlement.expires7days

New Entitlement Group

entitlement.group.created

Updated Entitlement Group

entitlement.group.updated

Entitlement Maintenance Expired

entitlement.maintenance.expired

Entitlement Maintenance Expires in 1 Day

entitlement.maintenance.expires1day

Entitlement Maintenance Expires in 30 Days

entitlement.maintenance.expires30days

Entitlement Maintenance Expires in 7 Days

entitlement.maintenance.expires7days

Entitlement Provision

entitlement.provision

Entitlement Renewed

entitlement.renewed

Entitlement Seat Activated

entitlement.seat.activated

Entitlement Seat Deactivated

entitlement.seat.deactivated

Entitlement Updated

entitlement.updated

Entitlement Usage Summary

entitlement.usage.summary

All Zentitle2 Searches

Search Name

Required Fields

Find Attribute

attributeId

Find Customer

customerId

Get Customers

pageNumber, pageSize

Find Customer Note

customerId, noteId

Find Customer Notes

customerId

Find Customer Stats

customerId

Find Entitlement

entitlementId

Get Entitlements

pageNumber, pageSize

Find Entitlement Activation

entitlementId

Find Entitlement Activations

entitlementId, pageNumber

Find Entitlement Activations Logs

entitlementActivationsLogId

Find Entitlement Group

entitlementGroupId

Get Entitlement Groups

pageNumber, pageSize

Find Entitlement Group Authorized Contacts

entitlementGroupId

Find Entitlement Note

entitlementId, noteId

Find Entitlement Notes

entitlementId

Find Feature

featureId

Find Offering

offeringId

Get Offerings

pageNumber, pageSize

Find Plan

planId

Get Plans

pageNumber, pageSize

Find Product

productId

Get Products

pageNumber, pageSize

Find Product Attribute

productId, attributeId

Find Product Attributes

productId

Find Product Edition

productId, editionId

Find Product Editions

productId

Find Product Edition Attribute

productId, editionId, attributeId

Find Product Edition Attributes

productId, editionId

Find Product Edition Feature

productId, editionId, featureId

Find Product Edition Features

productId, editionId

Find Product Feature

productId, featureId

Find Product Features

productId

All Zengain Triggers

Trigger Name

Event Code

New Customer

customer.created

Updated Customer

customer.updated

All Zengain Searches

Search Name

Required Fields

Find Customer

customerId

Get Customers

pageNumber, pageSize

Webhook Event Structure

All triggers return data in this format:

{ 
  "eventId": "event_abc123", 
  "eventCode": "customer.created", 
  "eventDate": "2024-01-15T10:30:00.000Z", 
  "resourceId": "cus_xyz789", 
  "callAttempt": 1, 
  "payload": { 
    // Event-specific data 
  } 
}

Best Practices

✅ Use filters to reduce task usage - only run when conditions are met

✅ Map IDs dynamically - don't hard-code values

✅ Chain searches - Find Customer → Find Entitlement → Find Product

✅ Test with real events - turn on Zap and trigger actual events

✅ Monitor Zap History - check for errors regularly

✅ Add error handling - use Paths for "not found" scenarios

✅ Secure credentials - rotate regularly, use test environment first

Zapier Support Resources

Quick Reference

  • Authentication: OAuth2 Client Credentials

  • Trigger Type: Webhooks (instant)

  • Search Type: GET by ID

  • Limitations:

    • No dynamic dropdowns

    • No create/update actions

    • Read-only

  • Task Count:

    • Each trigger execution

    • Each action = 1 task per step

PreviousZapier Native IntegrationNextSalesforce Integration Example

Last updated

Was this helpful?