Aurora CRM Form Integration

By toolsalbe

★ 5.0/5 (1 ratings)0+ active installationsVersion 1.0.1

Send your WordPress form submissions to Aurora CRM as leads, with a visual field mapping. Works with the most popular form plugins.

Description

Aurora CRM Form Integration connects the forms of your website to Aurora CRM. Every time a visitor submits a form, the data is sent to the Aurora CRM lead API and a new lead is created (or updated, if the link is configured to do so).

Supported form plugins

  • Contact Form 7
  • WPForms
  • Gravity Forms
  • Elementor Pro Forms
  • Fluent Forms
  • Ninja Forms
  • Any custom form, through a developer hook

Features

  • Mapping built from the JSON example. Paste the example body of the API and the plugin creates one mapping row for every field, nested ones included (for example customFields.*), and infers its type.
  • Automatic field detection. The fields of the selected form are listed and common names (first name, last name, email, phone, postal code…) are matched automatically.
  • Flexible values. Each JSON field can take the value of a form field ({email}), a combination of fields ({first_name} {last_name}) or a fixed value, which is handy for channel and category.
  • Type conversion. Numbers (e.g. “€ 12.500,00” becomes 12500), yes/no values and dates, always sent in the format 2025-09-16T00:00:00.000Z.
  • Secure token. The token of your lead link is added automatically, stored encrypted in the database and never exposed to visitors. It is only sent over HTTPS to the configured host.
  • Several connections. A form can send to several endpoints, and a connection can cover several forms.
  • Log and debug mode. The last 200 submissions (up to 30 days) are logged with payload and API response, and can be exported or erased with the WordPress privacy tools. In debug mode the payload is logged without calling the API, so you can test the mapping without creating leads.
  • Error emails. Optionally receive an email when the API returns an error.
  • Safe by design. Data is sent after the form plugin has validated the submission (spam check included), and an API error never blocks the form or its emails.

External services

This plugin connects to the Aurora CRM API to create leads from your form submissions. Aurora CRM is the customer relationship management service of the plugin author.

  • When: only when a visitor submits a form that you have connected in the plugin settings, and only if the connection is active and not in debug mode.
  • What is sent: the token of your Aurora CRM lead link and the form fields you have mapped (for example first name, last name, email, phone, address, tax code, date of birth and any custom field). Fields that are not mapped are never sent.
  • Where: by default to https://api.auroracrm.it/api/contacts/load/leads. The endpoint can be changed in each connection.

The service is provided by Aurora CRM: Terms of service – Privacy policy.

As the site owner, you must inform your visitors that the data they enter in the form is sent to Aurora CRM. The plugin adds a suggested paragraph to the WordPress privacy policy guide (Settings → Privacy).

Installation

  1. Install the plugin from Plugins → Add New, or upload the zip file, and activate it.
  2. Open Aurora CRM in the admin menu and click Add connection.
  3. Choose the form plugin and the form, and paste the token of your Aurora CRM lead link.
  4. Click Generate mapping, link every JSON field to a form field or a fixed value, and save.
  5. Turn on Debug mode, submit the form from your website and check the payload in Submission log. When it is correct, turn debug mode off.

FAQ

Where do I find the token?

In Aurora CRM, open the lead link you want to use: the token is shown in the API instructions of the link.

What values should I use for channel and category?

They must match exactly a channel and a category configured in Aurora CRM. Use a fixed value in the mapping, written exactly as it appears in the platform.

Can I use the plugin with another API?

Yes. The endpoint is configurable and the mapping works with any JSON body sent with a POST request.

My form plugin is not in the list.

Call the developer hook from your own code when the form is submitted:

do_action( 'auroracrm_submit', 'my-form', array( 'email' => 'mario@example.com' ) );

Then create a connection with the “Custom form” plugin and my-form as form.

Does an API error stop the form?

No. The form, its confirmation message and its emails always work. The error is written to the log and, if configured, emailed to you.

Is the token safe?

The token is stored encrypted with a key derived from the secret keys in your wp-config.php, it is never sent to the browser and it is masked in the log. If you change the secret keys of your site, enter the token again.

Which hooks are available for developers?

  • auroracrm_payload (filter): change the payload before it is sent.
  • auroracrm_request_args (filter): change the HTTP request arguments.
  • auroracrm_after_send (action): runs after each request, with log entry, connection, payload and response.
  • auroracrm_log_retention_days (filter): days the log entries are kept (default 30).
  • auroracrm_max_value_length (filter): maximum length of a submitted value (default 10000).

Screenshots

Changelog

1.0.1

  • Security: fixed the escaping of form names and field labels in the mapping screen.
  • Security: the API token is now stored encrypted in the database.
  • Security: requests are sent only to public HTTPS endpoints, without following redirects.
  • Security: the saved token is removed when the endpoint host changes.
  • Privacy: log entries are kept for 30 days and are included in the WordPress personal data export and erasure tools.
  • Privacy: error emails no longer contain the visitor’s data.
  • Submissions marked as spam by Fluent Forms are no longer sent.

1.0.0

  • First release.