What is an API?

API stands for Application Programming Interface, which is a standard method that software programs use to communicate with each other. It allows programmers to take advantage of other programs’ capabilities. APIs can also be used to automate complex tasks, thus streamlining your workflows.The Emarsys API can be used with any programming language which supports HTTP.

What is REST?
REpresentational State Transfer (REST) is the name of a software architecture for large and distributed systems composed of web services. The World Wide Web’s architecture is one example of a system that conforms to the REST constraints, therefore it can be called “RESTful”.

The Emarsys API is also built using such a REST-style architecture, a simpler and faster approach than its SOAP alternative. It communicates via HTTP requests and uses JSON as its content type and X-WSSE for authentication. Please note that not all data elements are RESTful.

The real REST resources are:

  • email
  • contactlist
  • contact
  • source

What is JSON?

JavaScript Object Notation (JSON) is a text-based data interchange format, which was optimized to be humanly-readable. It is often used for transmitting structured data over a network connection, serving as an alternative to XML.

What is the advantage of an API?

An API provides value in two areas: integration and automation. Integration means accessing the power and functionality of the Emarsys platform directly from within your own application. Automation means setting up complex eMarketing campaigns that run without the need for any human interaction on your side.

Doesn’t it cost a lot of time and effort to set up an API?

An integration does require effort and commitment from your side to set up.But this is a one-time investment: after you have set up your automated workflows you can create and launch email campaigns, update contact data, import and export contact lists, all at the touch of a button and without having to log in to another application. The greater your initial effort, the faster you will reap the benefits in hours saved.

Does the API support all UI features?

No. The main purpose of the API is to automate frequently used operations, not to replicate the full set of UI features. If you have any specific queries, our Technical Support teams are happy to help with advice and support. For more details on these and other terms used by the API, please refer to the Glossary.