NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Emelia connects to a Nagent workspace with an API key. Once it is connected, agents can call 22 Emelia actions, such as "Add Contact to Blacklist", "Add Contact To Campaign" and "Create Campaign". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Emelia, with input parameters and output schema.
EMELIA_ADD_CONTACT_TO_BLACKLISTTool to add a contact to the email blacklist. Use after confirming that no further emails should be sent to a specific address. Example: 'Add blocked_user@example.com to blacklist.'
Input parameters
The email address of the contact to be blacklisted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMELIA_ADD_CONTACT_TO_CAMPAIGNTool to add a contact to an email campaign. Use when you have collected subscriber details and want to enroll them in a campaign.
Input parameters
Campaign ID to which the contact will be added
Contact object containing email and optional name/fields
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMELIA_CREATE_CAMPAIGNTool to create a new email campaign. Use after you have finalized the campaign name.
Input parameters
Name of the email campaign
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMELIA_CREATE_LINKEDIN_CAMPAIGNTool to create a new LinkedIn campaign. Use when you need to launch a LinkedIn outreach sequence.
Input parameters
Name of the LinkedIn campaign to create
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMELIA_CREATE_WEBHOOKTool to create a new webhook for campaign events. Use when you need to subscribe to activity updates after determining the campaign ID and desired events.
Input parameters
The type of campaign the webhook is for.
List of events to subscribe to. For linkedin: VISITED, INVITED, ACCEPTED, MESSAGE_SENT, REPLIED; for email: REPLIED, OPENED, CLICKED, SENT, BOUNCED, UNSUBSCRIBED; for advanced: MAIL_REPLIED, OPENED, CLICKED, MAIL_SENT, BOUNCED, UNSUBSCRIBED, LINKEDIN_REPLIED, VISITED, ACCEPTED, MESSAGE_SENT, LIKED.
The destination URL for the webhook payloads.
The ID of the campaign to attach the webhook to (use 'ALL_CAMPAIGNS' for all campaigns)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMELIA_DELETE_CONTACT_FROM_CAMPAIGNTool to remove a contact from an email campaign. Use when you need to revoke a contact's subscription from a specific campaign. Note: this operation is irreversible.
Input parameters
The ID of the contact to remove from the campaign.
The ID of the campaign from which to remove the contact.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMELIA_DELETE_CONTACT_FROM_LINKEDIN_CAMPAIGNTool to delete a contact from a LinkedIn campaign. Use when you need to remove a contact by campaign ID and contact URL. Call after confirming the contact exists in the campaign.
Input parameters
The unique identifier of the LinkedIn campaign.
The LinkedIn profile URL of the contact to remove.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMELIA_DELETE_WEBHOOKTool to delete a specific webhook. Use when you need to remove an existing webhook by URL after identifying the campaign.
Input parameters
The type of campaign the webhook is attached to. Possible values: linkedin, email, advanced.
The exact URL of the webhook to delete.
The campaign ID to delete the webhook from (use 'ALL_CAMPAIGNS' for all campaigns).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMELIA_FIND_EMAIL_SINGLE_CONTACTTool to initiate a job to find the email address of a specific contact. Use when you have the contact's full name and company details and want to retrieve their email address.
Input parameters
Country of the contact or company (ISO 3166-1 alpha-2 code or name).
Full name of the contact to find (e.g., 'John Doe').
Name of the contact's company (e.g., 'Acme Corp').
Website of the contact's company (e.g., 'https://acme.com').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMELIA_GET_CAMPAIGN_ACTIVITIESTool to retrieve activities for a specific email campaign. Use after obtaining the campaign ID.
Input parameters
Page number for pagination (1-based index)
Filter activities by event type
Free-text search across activities
Filter activities by a specific contact ID
Filter activities by a specific campaign version ID
ID of the campaign to retrieve activities for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMELIA_GET_FIND_EMAIL_RESULTTool to retrieve the result of a previously initiated email find job. Use after initiating a find-email job to check its status and outcome.
Input parameters
The ID of the find-email job to retrieve the result for.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMELIA_GET_FIND_PHONE_RESULTTool to retrieve the outcome of a previously initiated phone-find job. Use after starting a job to fetch its status and details by job ID.
Input parameters
ID of the phone-find job to get the result for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMELIA_GET_LINKEDIN_CAMPAIGN_ACTIVITIESTool to retrieve activities for a campaign. Use when you need to inspect engagement events for a specific campaign.
Input parameters
Page number for pagination (must be >= 1).
Number of items per page (must be >= 1).
The ID of the LinkedIn campaign to retrieve activities for.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMELIA_GET_VERIFY_EMAIL_RESULTTool to get the result of an email verification job. Use after initiating an email verification job to check its status and outcome.
Input parameters
ID of the email verification job to get the result for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMELIA_INITIATE_EMAIL_VERIFICATION_JOBTool to initiate an asynchronous email verification job."
Input parameters
The email address to verify asynchronously.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMELIA_INITIATE_PHONE_FIND_JOBTool to initiate a phone-find job for a single contact. Use when you want to retrieve a contact's phone number based on their email address.
Input parameters
LinkedIn profile URL of the contact for which to find the phone number.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMELIA_LIST_CAMPAIGN_CONTACTSTool to list contacts in a specific email campaign. Use when you need to retrieve campaign subscribers with optional pagination.
Input parameters
Page number for pagination (1-based index). Defaults to 1.
Unique identifier of the email campaign.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMELIA_LIST_CAMPAIGNSTool to retrieve all email campaigns. Use when you need to fetch the list of campaigns, with optional pagination or search filters.
Input parameters
Page number for pagination (1-based index)
Number of items per page
Search string to filter campaigns by name or attributes
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMELIA_LIST_EMAIL_PROVIDERSTool to retrieve all configured email providers. Use after setting up your email providers to view them.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMELIA_LIST_LINKEDIN_CAMPAIGNSTool to list all LinkedIn campaigns. Use when you need an overview of your LinkedIn campaigns and want to paginate results.
Input parameters
Page number for pagination (must be >= 1).
Number of items per page (must be >= 1).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMELIA_LIST_WEBHOOKSTool to retrieve all webhooks. Use when you need to fetch every configured webhook in Emelia.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMELIA_REMOVE_CONTACT_FROM_BLACKLISTTool to remove a contact or domain from the email blacklist. Use after verifying that the address or domain should no longer be blocked.
Input parameters
The email address or domain to remove from the blacklist.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 22 Emelia actions on Nagent, including "Add Contact to Blacklist", "Add Contact To Campaign" and "Create Campaign". Add Contact to Blacklist: Add a contact to the email blacklist. Each action is listed on this page with its input parameters and its output.
Emelia connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
Add Contact to Blacklist takes 1 required input: email. It returns data, error and successful.