Mapping fields for a successful data import

It’s important to understand the data types for a successful fields mapping during the import of data. Whether you’re importing your contacts in a CSV file, or through API (Form submission, Ad campaigns, etc…); saving your data in the right place allows you to easily manipulate it to create Smartlists, search for leads, and launch automations.

Data Types

Mapping fields for a successful data import:

aNinja has both Standard fields which are the built-in default fields and Custom fields, which you customize to your needs.

Standard Fields

aNinja standard fields are found under the categories Lead’s Contacts, Company, and address.

  • Contact name: contact_name – is the only required field and it’s essential to complete the import.
  • Primary contact’s email: contact_email1
    • You can also add a second email – contact_email2
  • Primary contact’s phone: contact_phone1
    • You can also add a second phone number – contact_phone2
    • Here we recommend choosing the mobile number to be the primary contact phone
  • Company URL: lead.company.url
  • Company description or name: lead.company.description 
  • Lead Opportunities: lead.opportunities
  • Lead Address:
    • address_street1
    • address_street2
    • address_city
    • address_state
    • address_postalzip
Custom Fields

If you can’t see the fields that you need, you can create them manually upon import. Or in Settings > Custom Fields

Upon import, aNinja anticipates which Custom fields you might want to create and marks them as ‘New’. Mapping to a field marked ‘New’ creates a new Custom Field within aNinja.

Prefix your field’s name with “Custom.” so it is saved as a custom field in the lead page. (e.g. Custom.Source)

Types of Custom Fields

When you create a custom field in Settings > Custom fields, you can designate its type:

Text – For text input
Link – For fields with any link/URL
Date – Date in YYYY-MM-DD format
Dropdown – Fields with multiple options dropdown

Then, you can use it in the lead page and assign it a value to be able to group/search for specific leads when needed.

Where does the imported data appear?

After the import, you can search your aNinja CRM for the imported leads. You can also search for any custom field and any other info that you have imported.

  • Lead’s contacts appear in the leads contact section in the lead view
  • Opportunities also appear in the opportunity section in the lead view
  • The company’s info appears on the top left of the lead view, in the Company section.
  • Custom fields appear in the custom field section of the lead view
  • Lead Search is a field that also appears in the bottom left of the lead view. Specifically, these are info/links on the lead or the organization found in Google search.

Standalone / Curl Applications Integration

With Standalone / Curl Applications Integration you can forward leads into your aNinja account simply using a programming code or an API. In this article, we show you how the Standalone / Curl Applications Integration can be done.

Standalone / Curl Applications

The following example is in PHP, but can be repurposed to your language of choice (Python, Ruby, Java, etc..)

Sample PHP API push

/**
* Basic snippet for posting with command line curl
*/
$apikey = '123456';

function doCurl($apikey = null, $data = []) {
$data = http_build_query($data);

$api_base = 'https://aninja.com/api/v1';

$api_endpoint= '/contactform/?apikey='.$apikey.'';

$cmd = 'curl -sL --data ''.$data.'' "'.$api_base.'/'.$api_endpoint.'"';

Fields mapping Table

The following are standard fields you can map to, in addition to any custom fields created in your application that you can see under Settings > Custom fields.

Where does the imported data appear?

After the integration, you can search your aNinja CRM for the imported leads. You can also search for any custom field, opportunities, and any other info that you have imported.

  • Lead’s contacts appear in the leads contact section in the lead view
  • Opportunities also appear in the opportunity section in the lead view
  • The company’s info appears on the top left of the lead view, in the Company section.
  • Custom fields appear in the custom field section of the lead view
  • Lead Search is a field that also appears in the bottom left of the lead view. Specifically, these are info/links on the lead or the organization found in Google search.

Need help with teh Integration? Leave us an email at support@aninja.com. And we will happily assist you.

Javascript API Integration

With Javascript API Integration you can forward leads into your aNinja account simply using a programming code or an API. In this article, we show you how Javascript API Integration can be done.

Javascript applications

The following example is of an API request in Javascript. You can customize off of the following examples to suit your actual code/use case.

Example use cases: Squarespace, Shopify

ajax({
type: 'POST',
url: "https://aninja.com/api/v1/contactform/?apikey=YOUR_API_KEY_HERE",
data:$.param({contact_name : contact_name}) + "&"+ $.param({contact_email1 : contact_email1}) + "&"+ $.param({contact_phone1 : contact_phone1})+ "&"+ $.param({company_name : company_name}),
success: function (data) {
alert('success');
}
});

Fields mapping Table

The following are standard fields you can map to, in addition to any custom fields created in your application that you can see under Settings > Custom fields.

Where does the imported data appear?

After the integration, you can search your aNinja CRM for the imported leads. You can also search for any custom field, opportunities, and any other info that you have imported.

  • Lead’s contacts appear in the leads contact section in the lead view
  • Opportunities also appear in the opportunity section in the lead view
  • The company’s info appears on the top left of the lead view, in the Company section.
  • Custom fields appear in the custom field section of the lead view
  • Lead Search is a field that also appears in the bottom left of the lead view. Specifically, these are info/links on the lead or the organization found in Google search.

Need help with Javascript API Integration? Leave us an email at support@aninja.com. And we will happily assist you.

Webflow Integration using Zapier

Webflow integration can be done either through Zapier or through webhook. In this article, we’re going to show you the Webflow integration using Zapier.

Find your aNinja embed code before you get started. It is the form integration endpoint from aNinja. This is different for each form.

Sending Webflow form submissions to aNinja through Zapier

  • Log in to your Zapier account
  • Click on Make a Zap
  • ‍Choose Webflow as your Trigger App event
  • Connect the Webflow account. Make sure you are logged in to Webflow on the same browser.
  • Select Form Submission as Webflow trigger
  • Choose your Webflow Account
  • Set up Webflow Form Submission by selecting the site you want to receive notifications from and the Form Name
  • Test Trigger
  • For Action, choose Webhook.
  • For Event, select POST
  • Set up action
  • URL: Copy here the aNinja Form Embed code.Webflow Integration using Zapier
  • Payload Type: form

Mapping Fields

Map the Data on the aNinja fields and Form fields

These are the default aNinja fields:

contact_name

address_street1

address_street2

address_city

address_state

address_postalzip

address_country

company_name

company_url

company_description

contact_email1

contact_email2

contact_phone1

contact_phone2

date_created

user_id

Testing the Integration

  • Click Fetch & Continue to test the Webflow connection. Make sure you have at least one recent form submission created or submit a new form submission on your website before testing the connection. If there’s an issue with the connection troubleshoot your Webflow connection with Zapier (see below).
  • Check aNinja if the test lead got through.
  • Rename the Zap.
  • Publish Zap

Where does the imported data appear?

After the integration, you can search your aNinja CRM for the imported leads. You can also search for any custom field and any other info that is collected from the forms. All the data appear in the Lead View.

  • Lead’s contact (Name, address, email, phone, and email) appears in the leads contact section in the lead view
  • The company’s info appears on the top left of the lead view, in the Company section.
  • Custom fields appear in the custom field section of the lead view
  • Lead Search is a field that also appears in the bottom left of the lead view. Specifically, these are info/links on the lead or the organization found in Google search.

Need help with the Webflow Integration using Zapier? Leave us an email at support@aninja.com. We’re more than happy to assist you.

Webflow Webhook Integration

Webflow integration can be done either through Zapier or through webhook. In this article we’re going to show you the Webflow through webhook

What’s a Webhook?

A webhook is a lightweight API that powers one-way data sharing, triggered by events. And it delivers data to other applications as it happens, meaning you get data immediately. All you have to do is give the webhook provider (e.g.Webflow) a URL to deliver requests to (e.g. aNinja’s URL).

So, with Webflow Webhook Integration you can forward leads into your aNinja account simply by setting up a Webhook for your form submission. Find your aNinja API key before getting started.

Setting up a webhook in Webflow

  • First, log in to your Webflow account.
  • Then, go to your Webflow Project Settings.Webflow Webhook Integration
  • Choose Integrations.Webflow Webhook Integration
  • Click + Add webhook (at the bottom)
  • Here, you need to find your aNinja API key
  • Lastly, Set the webhook on “Form submissions” and use the endpoint URL: https://leads.aninja.com/handlers/webflow/redirect.php?apikey=YOUR_ANINJA_API_KEY <– replace with your aNinja API key.

Fields mapping

aNinja expects the form to have the fields Name and email.

  • Name: Map it to contact_name (required field)
  • Email: Map it to contact_email1

Where does the imported data appear?

After the integration, you can search your aNinja CRM for the imported leads. The name and email appear in the lead’s contact section in the lead view. Need help with Webflow Webhook Integration? Leave us an email at support@aninja.com. And we will happily assist you.

Squarespace API Integration

With Squarespace API Integration you can forward leads into your aNinja account simply using a programming code or an API. In this article, we show you how the Squarespace API Integration can be done.

Squarespace API Integration

The following example is specific to Squarespace (add in the “Page section Settings > Advanced tab > Page header code injection text area section for the page where you have the form you want to forward into aNinja).

// SQUARESPACE - example 1
// Add in javascript advanced:
<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.2.1/jquery.min.js"></script>
<script>
$(document).ready(function() {
$('form').submit(function(e) {
var contact_name = $("input[name='fname']").val();
var contact_email1 = $( "input[name='email']").val();
var phone_areacode = $('*[data-title="Areacode"]').val();
var phone_prefix= $('*[data-title="Prefix"]').val();
var phone_line = $('*[data-title="Line"]').val();
var contact_phone1 = phone_areacode+phone_prefix+phone_line;
var subject = $($('select')[0]).val();
var pref_contact_method = $($('select')[1]).val();
var message = $('textarea#textarea-yui_3_17_2_1_1442700176413_134868-field').val();

$.ajax({
type: 'post',
url: "https://aninja.com/api/v1/contactform/?apikey=YOUR_API_KEY_HERE",
data: {
'contact_name': contact_name,
'contact_email1': contact_email1,
'contact_phone1': contact_phone1,
'your-comments': 'message: '+message+' subject:'+subject+' pref_contact_method: '+pref_contact_method
},
success: function (data) {
// alert('success');
}
});
});
});
</script>

Fields mapping Table

The following are standard fields you can map to, in addition to any custom fields created in your application that you can see under Settings > Custom fields.

Where does the imported data appear?

After the integration, you can search your aNinja CRM for the imported leads. You can also search for any custom field, opportunities, and any other info that you have imported.

  • Lead’s contacts appear in the leads contact section in the lead view
  • Opportunities also appear in the opportunity section in the lead view
  • The company’s info appears on the top left of the lead view, in the Company section.
  • Custom fields appear in the custom field section of the lead view
  • Lead Search is a field that also appears in the bottom left of the lead view. Specifically, these are info/links on the lead or the organization found in Google search.

Need help with Squarespace API Integration? Leave us an email at support@aninja.com. And we will happily assist you.

WordPress Forms aNinja Integration

WordPress Forms aNinja integration is a way to integrate WordPress websites into your aNinja account.

After the integration, a lead is injected into your aNinja account after each form submission.

aNinja Integration

WordPress Sites Integration

You can integrate and augment the functionality of popular platforms with aNinja, including Shopify, Squarespace, WordPress, and Wix.

Where does the imported data appear?

After the integration, you can search your aNinja CRM for your leads. You can also search for any custom field, opportunities, and any other info that you have imported.

  • Lead’s contacts appear in the leads contact section in the lead view
  • Opportunities also appear in the opportunity section in the lead view
  • The company’s info appears on the top left of the lead view, in the Company section.
  • Custom fields appear in the custom field section of the lead view
  • Lead Search is afield that also appears in the bottom left of the lead view. Specifically, these are info/links on the lead or the organization found in Google search.

Need help in your aNinja integrations? Leave us an email at support@aninja.com. We will happily assist you!