Skip to main content

​
Overview

The Apten Power Automate connector enables you to automate lead engagement workflows directly from Microsoft Power Automate. You can create leads, send messages, and manage lead status without leaving the Power Platform. Use cases include:
  • Automatically create leads in Apten when new contacts appear in SharePoint, Dynamics 365, or other systems
  • Send follow-up messages based on triggers from your CRM or email
  • Sync lead status between Apten and your other business applications

​
Prerequisites

Before getting started, ensure you have:
  1. Power Automate account with Premium license - Custom connectors require a Power Automate Premium license ($15/user/month) or a Per Flow license
  2. Apten account with API access - Contact your Apten account manager if you need API access enabled
  3. Apten API key - See the next section for how to obtain one

​
Getting Your API Key

To use the Apten connector, you need an API key from your Apten dashboard:
  1. Log in to your Apten dashboard at platform.attent.app
  2. Navigate to Developer Portal in the left sidebar
  3. Under “Generate New API Key”, give your key a descriptive name (e.g., “Power Automate Integration”)
  4. Click “Request API Key”
  5. Copy the generated API key
Keep your API key confidential. Do not share it or commit it to version control.

​
Importing the Connector

1

Download the solution

Download the Apten connector solution:
2

Open Power Automate

Go to make.powerautomate.com
3

Navigate to Solutions

In the left navigation, click Solutions
4

Import the solution

Click Import solution in the top bar
5

Upload the file

Click Browse, select the downloaded Apten_1_0_0_0_managed.zip file, and click Next
6

Complete the import

Review the solution details and click Import
The Apten connector is now available in your environment.

​
Creating a Connection

Before using the connector in a flow, you need to create a connection with your API key:
  1. In Power Automate, go to Data > Connections
  2. Click + New connection
  3. Search for “Apten” and select the Apten connector
  4. Enter your API key when prompted
  5. Click Create
You can now use the Apten connector in your flows.

​
Available Actions

The Apten connector provides 20 actions organized into four categories.

​
Lead Management

Creates a new lead in Apten with the specified contact information.
  • Required: Customer Profile, First Name, Phone
  • Optional: Last Name, Email, Timezone, Additional Info
  • Returns: Lead ID
Retrieves details about an existing lead.
  • Required: Lead ID
  • Returns: Lead details (name, phone, email, status, tags, etc.)
Updates an existing lead’s information.
  • Required: Lead ID
  • Optional: Email, Timezone, Additional Info, Follow-up Config, Follow-up Step
  • Returns: Confirmation
Permanently deletes a lead.
  • Required: Lead ID
  • Returns: Confirmation
Finds a lead by their phone number.
  • Required: Phone
  • Returns: Lead ID if found
Resubscribes a lead who previously opted out, allowing messages to be sent again.
  • Required: Lead ID
  • Returns: Confirmation

​
Messaging & Engagement

Sends a message to a lead via SMS.
  • Required: Lead ID, Message
  • Optional: Scheduled Time, Send When Off, Override Business Hours
  • Returns: Confirmation
Retrieves the message history for a lead.
  • Required: Lead ID
  • Returns: Array of messages with content, timestamp, and sender
Enables AI-powered messaging for a lead.
  • Required: Lead ID
  • Returns: Confirmation
Disables AI-powered messaging for a lead.
  • Required: Lead ID
  • Returns: Confirmation
Adds contextual information to help the AI better engage with the lead.
  • Required: Lead ID, Context
  • Returns: Confirmation
Records an event that occurred for the lead (e.g., “clicked email link”).
  • Required: Lead ID, Event
  • Returns: Confirmation
Changes the customer profile (campaign/persona) for a lead.
  • Required: Lead ID, New Customer Profile
  • Optional: Resend First Touch, Reset Follow-up
  • Returns: Confirmation

​
Tags

Retrieves all tags available in your organization.
  • Returns: Array of tags with name and color
Adds tags to a lead.
  • Required: Lead ID, Tags (array)
  • Returns: Updated tag list
Replaces all tags on a lead with a new set.
  • Required: Lead ID, Tags (array)
  • Returns: Updated tag list
Removes specific tags from a lead.
  • Required: Lead ID, Tags (array)
  • Returns: Updated tag list

​
Do Not Contact (DNC)

Adds a phone number to the Do Not Contact list.
  • Required: Phone Number
  • Returns: Confirmation
Checks if a phone number is on the DNC list.
  • Required: Phone Number
  • Returns: DNC status and date added (if on list)
Removes a phone number from the DNC list.
  • Required: Phone Number
  • Returns: Confirmation

​
Example Flow

Here is a simple example flow that creates a lead in Apten when a new item is added to a SharePoint list.

​
Scenario

When a new contact is added to a “New Leads” SharePoint list, automatically create a corresponding lead in Apten.

​
Steps

  1. Create a new flow in Power Automate
  2. Add trigger: Search for “SharePoint” and select When an item is created
    • Site Address: Select your SharePoint site
    • List Name: Select your “New Leads” list
  3. Add action: Search for “Apten” and select Create Lead
    • Customer Profile: Enter your Apten profile name (e.g., “sales-outreach”)
    • First Name: Select the First Name column from SharePoint (dynamic content)
    • Last Name: Select the Last Name column from SharePoint
    • Phone: Select the Phone column from SharePoint
    • Email: Select the Email column from SharePoint
  4. Save your flow
Now, whenever a new item is added to your SharePoint list, a lead will automatically be created in Apten with the contact’s information.

​
Troubleshooting

Solution:
  • Verify your API key is correct
  • Check that your API key has not been revoked in the Apten dashboard
  • Create a new connection with a fresh API key
Solution:
  • Verify the Lead ID is correct
  • Ensure the lead has not been deleted
  • Use the Lead Lookup action to find a lead by phone number
Solution:
  • Use E.164 format for phone numbers (e.g., +15551234567)
  • Include the country code
  • Remove spaces, dashes, and parentheses
Solution:
  • Add a delay between actions in your flow
  • Reduce the frequency of your automated workflows
  • Contact Apten support if you need higher rate limits
Solution:
  • Check your internet connection
  • Verify the Apten API is accessible
  • Ensure your API key is valid and has not expired
  • Try creating a new connection
Solution:
  • Review the required fields for the action
  • Ensure all required fields have values (not empty or null)
  • Check that dynamic content is properly mapped

​
Support

If you encounter issues not covered in this guide, contact us at [email protected]. When contacting support, please include:
  • Your flow ID or screenshot
  • The error message you received
  • The action that failed