API for Email marketing services: Difference between revisions

From Planfix
Jump to: navigation, search
No edit summary
Line 39: Line 39:
|}
|}
==Supported actions==
==Supported actions==
*[[#createList — Create a mailing list|createList]] — create a mailing list
*[[#deleteList — Delete a mailing list|deleteList]] — delete a mailing list
*[[#importContacts — Import contacts into a List|importContacts]] — import contacts into a list
*[[#updateContact — Update сontact|updateContact]] — update contact

Revision as of 09:16, 5 March 2025

This API was developed to integrate with external email services. It allows you to manage mailing lists and contacts via a single endpoint (e.g., https://yourserver.com/planfix_integration.php) and accepts requests in JSON format.

Once you have implemented the integration, you can contact our Support Service to add your service to the list of integrations available to users in the Planfix interface.

Connecting to Planfix

  • Go to the Account management — Integrations — Email marketing section to connect and configure the integration.
  • In the opened section, select Planfix API at the end of the list.
  • A window for the integration settings will open.
  • You must specify the address where Planfix should send the requests and the API Key for authorization.

Request format

The request is sent via POST method in JSON format to the address specified in the integration settings.

Request Example:
{
  "action": "action",
  "authToken": "your_authorization_token",
  "data": {
    // Data depending on the action
  }
}

Request Parameters:

Name Description Type/Data Format Note
action The action to be performed string
authToken Authorization token for API access string
data Data depending on the action object

Supported actions