Custom integrations by the MDE dev team

Custom integrations connect HLB to other software your business uses, such as an online store, a support ticketing system, an event registration tool or a web form. HLB gives developers several building blocks for this work.

• Private integrations: generate a token from your account settings and choose only the scopes the integration needs. These tokens use API v2.0, which has more APIs than the older API keys and supports webhooks. Copy the token right away, because you cannot view it again later. Tokens stay fixed until you rotate them, and rotating with the expire later option keeps the old and new tokens working for 7 days.
• Inbound webhook trigger: another system sends data to a workflow URL using POST, GET or PUT. Map the data to create or update a contact, which needs an email or phone field, and use the values in communication actions and if/else branches.
• Custom webhook action: a workflow sends data to any URL, with your choice of method, authorization, headers and query parameters.
• TypeScript and JavaScript SDK: handles OAuth installation, token storage and refresh, and calls to supported public APIs, with a storage option of your choice.
• MCP server: lets compatible AI assistants use your account tools, limited by the permissions you grant.

When you use a custom webhook action, make sure the receiving API responds successfully and its server can handle your request volume. If the API returns errors, the action can fail and be skipped, or retry with increasing wait times. By default, all account admins can create and manage private integrations. You can restrict that permission for individual users in their roles and permissions under Settings, then My Staff.