Encharge

Encharge

Encharge is a marketing automation platform for email campaigns, user segmentation, and behavior-based workflows. Auth via X-Encharge-Token header.

Data Model

• People (contacts) — the core entity. Email, name, userId, tags, custom fields. Belongs to zero or one account.
• Accounts — company/organization records for B2B. People can be associated with an account.
• Tags — labels on contacts for categorization. Added/removed per person. Comma-separated for bulk operations.
• Segments — saved dynamic filters (e.g., "Active subscribers"). Each has a numeric ID and contact count.
• Fields — custom field definitions extending the contact schema. Name, type (text/number/date/boolean), ID.
• Schemas — data model definitions describing object types and field structures.

Capabilities

Read: Paginate through contacts, enumerate segments, drill into segment membership, read fields, schemas, accounts, account tags.

Write: Create or update contacts by email (upsert), add/remove tags on contacts, unsubscribe contacts from all emails.

Common Workflows

• Add a new lead: Create a person with email, name, and tags → the person enters any matching automation flows automatically.
• Audience segmentation: Enumerate segments → drill into a specific segment to see matching contacts → add/remove tags to recategorize.
• Contact cleanup: Paginate through all contacts → unsubscribe inactive ones → remove stale tags.
• Bulk tagging: Add tags to contacts by email to trigger tag-based automations.

Gotchas

• Upsert by email — creating a person with an existing email updates that person instead of creating a duplicate.
• Offset-token pagination — contact lists return an opaque offset token. Pass it back to fetch the next page. No page numbers.
• Tags are additive — adding tags merges with existing tags. Removing tags only removes the specified ones.
• Unsubscribe is irreversible via API — once unsubscribed, a contact cannot be resubscribed through the API.
• Segment ID required — segment drill-down requires a valid numeric segment ID. Enumerate segments first.