fbpx

Add Emercury to Your Website or App

Create integrations that connect Emercury to a CMS, blog, shopping cart, and more. Our API offers in-depth documentation, a download section for various wrappers, and how-to documents. The majority of data and functionality within our web application is accessible, so the integration possibilities are endless.

Not a programmer? Here are a few options that don't involve using our API directly:

What You Can Do with the API

The Emercury API allows you to sync your database with Emercury for better list and campaign management. Create client portals, add a subscribe form to your checkout page, segment campaigns based on purchase history, link campaign stats to your database, sync email activity with your database, and more.

Add Emercury to Your Website or App

Please use this API url to send your requests: https://panel.emercury.net/api.php

***note: please download the example of the sample API file: https://panel.emercury.net/files/download.php?sample

Test Scenario (This is not a real account or API key)

Here is the common authorization request:
<?xml version="1.0" encoding="utf-8 "? >
<request>
<user mail="test@test.com" API_key ="12345ABCD EF67890GHIJK"></user>
</request>
– <request> – query container that includes all required fields
– <user> – client's information (email and API key)
To call any function tag <method></method > used.

ImportSubscribers

importSubscribers 123456 http://panel.v4.emercurymail.net/test_list.csv E -mail date ip source web site First Name Last Name 0 --- Subscribers imported successfully. Error Response: Audience not found. - there is no such audience for your account. No file. - file not found. File must be no more than 10MB. - file exceed 10MB size. File can not be loaded. - can not load the file. File uploading error. - error while uploading the file. Headers from file not equal field. - fields in xml or headers in csv are missing or different. Header in csv should correspond to system name of the field (can be checked in Forms → Fields Manager → Variable Name) Headers in file must be equal to fields. - fields in xml and headers in csv are different. They should have same names. Cannot read file. - can not read uploaded file. Cannot move file to upload dir. - can not mo ve file to folder on serrver. Subscribers imported failed. - import failed

ImportSubscribers

Request

<?xml version="1.0" encoding="utf-8  "? > 
<request> 
<user mail="test@test.com" API_key="12345ABCD  EF67890GHIJK"/>  
<method>importSubscribers</method>  
<parameters > 
<audience_id>123456</audience_id> 
<path>http://panel.v4.emercurymail.net/test_list.csv</path> 
<fields> 
<email>E -mail</email> 
<optin_date>date</optin_date> 
<optin_ip>ip source</optin_ip  >  
<optin_website>web site</optin_website> 
<user_field_1>First Name </user_field_1>  
<user_field_2>Last Name</user_field_2 >  
</fields> 
<is_ftp >0</is_ftp> 
</parameters> 
</request>

Response

<?xml version="1.0" encoding="utf-8 "? > 
<emercurymailAPI xmlns:xsi="http://www.w3.org/2001/X MLSchema -instance"> 
  <subscribers> 
  <message>Subscribers imported successfully.</message> 
  </subscribers> 
</emercurymailAPI> 
 
Error Response:  
 
<?xml version="1.0" encoding="utf-8 "? > 
<emercurymailAPI xmlns:xsi="http://www.w3.org/2001/X MLSchema -instance"> 
  <error>Audience not found. </error>  
</emercurymailAPI> 
- there is no such audience for your  account. 
 
 <?xml version="1.0" encoding="utf-8 "? > 
<emercurymailAPI xmlns:xsi="http://www.w3.org/2001/X MLSchema -instance"> 
  <error>No file.</error>  
</emercurymailAPI> 
- file not found.  
  
<?xml version="1.0" encoding="utf-8 "? > 
<emercurymailAPI xmlns:xsi="http://www.w3.org/2001/X MLSchema -instance"> 
  <error>File must be no more than 10MB. </error>  
</emercurymailAPI> 
- file exceed 10MB size. 
 
 <?xml version="1.0" encoding="utf-8 "? > 
<emercurymailAPI xmlns:xsi="http://www.w3.org/2001/X MLSchema -instance"> 
  <error>File can not be loaded.</error>  
</emercurymailAPI> 
- can not load the file. 
 
 
<?xml version="1.0" encoding="utf-8 "? > 
<emercurymailAPI xmlns:xsi="http://www.w3.org/2001/X MLSchema -instance"> 
  <error>File uploading error.</error> 
</emercurymailAPI> 
- error while uploading the file. 
 
 <?xml version="1.0" encoding="utf-8 "? > 
<emercurymailAPI xmlns:xsi="http://www.w3.org/2001/X MLSchema -instance"> 
  <error>Headers from file not equal field.</error>  
</emercurymailAPI> 
- fields in xml or headers in csv are missing or different. Header in csv should correspond
 to system name of the field (can be checked in Forms → Fields Manager → Variable Name) 
 
 <?xml version="1.0" encoding="utf-8 "? > 
<emercurymailAPI xmlns:xsi="http://www.w3.org/2001/X MLSchema -instance"> 
  <error>Headers in file must be equal to fields.</error> 
</emercurymailAPI> 
- fields in xml and headers in csv are different. They should have same names. 
 
 <?xml version="1.0" encoding="utf-8 "? > 
<emercurymailAPI xmlns:xsi="http://www.w3.org/2001/X MLSchema -instance"> 
  <error>Cannot read file.</error>  
</emercurymailAPI> 
- can not read uploaded file. 
 
 <?xml version="1.0" encoding="utf-8 "? > 
<emercurymailAPI xmlns:xsi="http://www.w3.org/2001/X MLSchema -instance"> 
  <error>Cannot move  file to upload dir.</error>  
</emercurymailAPI> 
- can not mo ve file to folder on serrver. 
 
 <?xml version="1.0" encoding="utf-8 "? > 
<emercurymailAPI xmlns:xsi="http://www.w3.org/2001/X MLSchema -instance"> 
  <error>Subscribers imported failed.</error> 
</emercurymailAPI> 
- import failed 
Emercury. All Rights Reserved © Copyright 2002-2020
Memberships
Partners