diff --git a/forms-bridge/addons/mautic/assets/logo.png b/forms-bridge/addons/mautic/assets/logo.png
new file mode 100644
index 00000000..d9b5b0f6
Binary files /dev/null and b/forms-bridge/addons/mautic/assets/logo.png differ
diff --git a/forms-bridge/addons/mautic/class-mautic-addon.php b/forms-bridge/addons/mautic/class-mautic-addon.php
new file mode 100644
index 00000000..032cd683
--- /dev/null
+++ b/forms-bridge/addons/mautic/class-mautic-addon.php
@@ -0,0 +1,239 @@
+<?php
+/**
+ * Class Mautic_Addon
+ *
+ * @package formsbridge
+ */
+
+namespace FORMS_BRIDGE;
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit();
+}
+
+require_once 'class-mautic-form-bridge.php';
+require_once 'hooks.php';
+
+/**
+ * Mautic addon class.
+ */
+class Mautic_Addon extends Addon {
+
+	/**
+	 * Holds the addon's title.
+	 *
+	 * @var string
+	 */
+	public const TITLE = 'Mautic';
+
+	/**
+	 * Holds the addon's name.
+	 *
+	 * @var string
+	 */
+	public const NAME = 'mautic';
+
+	/**
+	 * Holds the addon's custom bridge class.
+	 *
+	 * @var string
+	 */
+	public const BRIDGE = '\FORMS_BRIDGE\Mautic_Form_Bridge';
+
+	/**
+	 * Holds the list of known Mautic API endpoints indexed by HTTP method.
+	 *
+	 * @var array<string, string[]>
+	 */
+	private const ENDPOINTS = array(
+		'POST' => array(
+			'/api/contacts/new',
+			'/api/companies/new',
+		),
+		'GET'  => array(
+			'/api/contacts',
+			'/api/companies',
+			'/api/segments',
+			'/api/fields/contact',
+			'/api/fields/company',
+		),
+	);
+
+	/**
+	 * Performs a request against the backend to check the connexion status.
+	 *
+	 * @param string $backend Backend name.
+	 *
+	 * @return boolean
+	 */
+	public function ping( $backend ) {
+		$bridge = new Mautic_Form_Bridge(
+			array(
+				'name'     => '__mautic-' . time(),
+				'endpoint' => '/api/contacts',
+				'method'   => 'GET',
+				'backend'  => $backend,
+			)
+		);
+
+		$response = $bridge->submit( array( 'limit' => 1 ) );
+
+		if ( is_wp_error( $response ) ) {
+			Logger::log( 'Mautic backend ping error response', Logger::ERROR );
+			Logger::log( $response, Logger::ERROR );
+			return false;
+		}
+
+		return true;
+	}
+
+	/**
+	 * Returns the list of available API endpoints.
+	 *
+	 * @param string      $backend Backend name.
+	 * @param string|null $method HTTP method.
+	 *
+	 * @return array
+	 */
+	public function get_endpoints( $backend, $method = null ) {
+		if ( $method ) {
+			return self::ENDPOINTS[ strtoupper( $method ) ] ?? array();
+		}
+
+		return array_values(
+			array_unique( array_merge( ...array_values( self::ENDPOINTS ) ) )
+		);
+	}
+
+	/**
+	 * Performs an introspection of the backend endpoint and returns API fields.
+	 *
+	 * The contact and company endpoints accept the instance's custom fields by
+	 * alias, so the fields are fetched from the Mautic fields API.
+	 *
+	 * @param string      $endpoint API endpoint.
+	 * @param string      $backend Backend name.
+	 * @param string|null $method HTTP method.
+	 *
+	 * @return array List of fields and content type of the endpoint.
+	 */
+	public function get_endpoint_schema( $endpoint, $backend, $method = null ) {
+		if ( 'POST' !== strtoupper( $method ?? 'POST' ) ) {
+			return array();
+		}
+
+		if ( '/api/contacts/new' === $endpoint ) {
+			$object = 'contact';
+		} elseif ( '/api/companies/new' === $endpoint ) {
+			$object = 'company';
+		} else {
+			return array();
+		}
+
+		$bridge = new Mautic_Form_Bridge(
+			array(
+				'name'     => '__mautic-endpoint-introspection',
+				'backend'  => $backend,
+				'endpoint' => "/api/fields/{$object}",
+				'method'   => 'GET',
+			)
+		);
+
+		$response = $bridge->submit( array( 'limit' => 1000 ) );
+
+		if ( is_wp_error( $response ) ) {
+			return array();
+		}
+
+		$fields = array();
+		foreach ( $response['data']['fields'] ?? array() as $field ) {
+			if ( empty( $field['alias'] ) || ( isset( $field['isPublished'] ) && ! $field['isPublished'] ) ) {
+				continue;
+			}
+
+			switch ( $field['type'] ?? 'text' ) {
+				case 'number':
+					$schema = array( 'type' => 'number' );
+					break;
+				case 'boolean':
+					$schema = array( 'type' => 'boolean' );
+					break;
+				case 'multiselect':
+					$schema = array(
+						'type'  => 'array',
+						'items' => array( 'type' => 'string' ),
+					);
+					break;
+				default:
+					$schema = array( 'type' => 'string' );
+					break;
+			}
+
+			$fields[] = array(
+				'name'     => $field['alias'],
+				'schema'   => $schema,
+				'required' => ! empty( $field['isRequired'] ),
+			);
+		}
+
+		if ( 'contact' === $object ) {
+			$fields[] = array(
+				'name'   => 'ipAddress',
+				'schema' => array( 'type' => 'string' ),
+			);
+
+			$fields[] = array(
+				'name'   => 'tags',
+				'schema' => array(
+					'type'  => 'array',
+					'items' => array( 'type' => 'string' ),
+				),
+			);
+
+			$fields[] = array(
+				'name'   => 'segments',
+				'schema' => array(
+					'type'  => 'array',
+					'items' => array( 'type' => 'integer' ),
+				),
+			);
+		}
+
+		$fields[] = array(
+			'name'   => 'owner',
+			'schema' => array( 'type' => 'integer' ),
+		);
+
+		$fields[] = array(
+			'name'   => 'overwriteWithBlank',
+			'schema' => array( 'type' => 'boolean' ),
+		);
+
+		return OpenAPI::expand_fields_schema( $fields );
+	}
+
+	/**
+	 * Gets expiration time for introspection cache based on the introspection
+	 * method.
+	 *
+	 * @param string $method Introspection method (ping, endpoints, schema).
+	 *
+	 * @return int Time in seconds.
+	 */
+	public function introspection_cache_expiration( $method ) {
+		if ( Logger::is_active() ) {
+			return 0;
+		}
+
+		switch ( $method ) {
+			case 'ping':
+			case 'endpoints':
+			case 'schema':
+				return 60 * 60 * 24;
+			default:
+				return 0;
+		}
+	}
+}
+
+Mautic_Addon::setup();
diff --git a/forms-bridge/addons/mautic/class-mautic-form-bridge.php b/forms-bridge/addons/mautic/class-mautic-form-bridge.php
new file mode 100644
index 00000000..7f9d9f43
--- /dev/null
+++ b/forms-bridge/addons/mautic/class-mautic-form-bridge.php
@@ -0,0 +1,139 @@
+<?php
+/**
+ * Class Mautic_Form_Bridge
+ *
+ * @package formsbridge
+ */
+
+namespace FORMS_BRIDGE;
+
+use WP_Error;
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit();
+}
+
+/**
+ * Form bridge implementation for the Mautic REST API.
+ */
+class Mautic_Form_Bridge extends Form_Bridge {
+
+	/**
+	 * Holds the keys of the Mautic API collection responses. Mautic serializes
+	 * its collections as objects indexed by entity ID.
+	 *
+	 * @var string[]
+	 */
+	private const COLLECTIONS = array( 'contacts', 'companies', 'lists', 'fields' );
+
+	/**
+	 * Bridge constructor with addon name provisioning.
+	 *
+	 * @param array $data Bridge data.
+	 */
+	public function __construct( $data ) {
+		parent::__construct( $data, 'mautic' );
+	}
+
+	/**
+	 * Submits payload to the Mautic API. On contact creation, the contact is
+	 * added to the segments listed on the `segments` payload field.
+	 *
+	 * @param array $payload Payload data.
+	 * @param array $attachments Submission's attached files.
+	 *
+	 * @return array|WP_Error Http request response.
+	 */
+	public function submit( $payload = array(), $attachments = array() ) {
+		$segments = array();
+
+		if ( 'POST' === $this->method && '/api/contacts/new' === $this->endpoint ) {
+			$segments = self::segment_ids( $payload['segments'] ?? array() );
+			unset( $payload['segments'] );
+		}
+
+		$response = parent::submit( $payload, $attachments );
+
+		if ( is_wp_error( $response ) ) {
+			return $response;
+		}
+
+		if ( ! empty( $response['data']['errors'] ) ) {
+			return new WP_Error(
+				'mautic_api_error',
+				'Mautic bridge response error',
+				array( 'response' => $response )
+			);
+		}
+
+		if ( 'GET' === $this->method && is_array( $response['data'] ) ) {
+			foreach ( self::COLLECTIONS as $collection ) {
+				if ( isset( $response['data'][ $collection ] ) && is_array( $response['data'][ $collection ] ) ) {
+					$response['data'][ $collection ] = array_values( $response['data'][ $collection ] );
+				}
+			}
+		}
+
+		if ( empty( $segments ) ) {
+			return $response;
+		}
+
+		$contact_id = $response['data']['contact']['id'] ?? null;
+		if ( ! $contact_id ) {
+			return new WP_Error(
+				'mautic_segments_error',
+				'Mautic contact ID not found on the API response',
+				array( 'response' => $response )
+			);
+		}
+
+		$backend = $this->backend();
+		foreach ( $segments as $segment_id ) {
+			$segment_response = $backend->post(
+				"/api/segments/{$segment_id}/contact/{$contact_id}/add"
+			);
+
+			if ( is_wp_error( $segment_response ) ) {
+				return $segment_response;
+			}
+
+			if ( empty( $segment_response['data']['success'] ) ) {
+				return new WP_Error(
+					'mautic_segments_error',
+					'Mautic can not add the contact to the segment',
+					array(
+						'segment'  => $segment_id,
+						'response' => $segment_response,
+					)
+				);
+			}
+		}
+
+		return $response;
+	}
+
+	/**
+	 * Normalizes the segments payload field value to a list of segment IDs.
+	 *
+	 * @param mixed $value Segments field value.
+	 *
+	 * @return int[]
+	 */
+	private static function segment_ids( $value ) {
+		if ( is_string( $value ) ) {
+			$value = explode( ',', $value );
+		} elseif ( ! is_array( $value ) ) {
+			$value = array( $value );
+		}
+
+		$ids = array();
+		foreach ( $value as $id ) {
+			$id = (int) $id;
+			if ( $id > 0 && ! in_array( $id, $ids, true ) ) {
+				$ids[] = $id;
+			}
+		}
+
+		return $ids;
+	}
+}
diff --git a/forms-bridge/addons/mautic/hooks.php b/forms-bridge/addons/mautic/hooks.php
new file mode 100644
index 00000000..b5b405be
--- /dev/null
+++ b/forms-bridge/addons/mautic/hooks.php
@@ -0,0 +1,157 @@
+<?php
+/**
+ * Mautic addon hooks.
+ *
+ * @package formsbridge
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit();
+}
+
+add_filter(
+	'forms_bridge_template_defaults',
+	function ( $defaults, $addon, $schema ) {
+		if ( 'mautic' !== $addon ) {
+			return $defaults;
+		}
+
+		return wpct_plugin_merge_object(
+			array(
+				'fields'     => array(
+					array(
+						'ref'         => '#backend',
+						'name'        => 'name',
+						'description' => __(
+							'Label of the Mautic API backend connection',
+							'forms-bridge'
+						),
+						'default'     => 'Mautic API',
+					),
+					array(
+						'ref'         => '#backend',
+						'name'        => 'base_url',
+						'description' => __(
+							'Base URL of your Mautic instance',
+							'forms-bridge'
+						),
+						'type'        => 'url',
+						'default'     => 'https://mautic.example.coop',
+					),
+					array(
+						'ref'      => '#credential',
+						'name'     => 'name',
+						'label'    => __( 'Name', 'forms-bridge' ),
+						'type'     => 'text',
+						'required' => true,
+					),
+					array(
+						'ref'   => '#credential',
+						'name'  => 'schema',
+						'type'  => 'text',
+						'value' => 'Basic',
+					),
+					array(
+						'ref'         => '#credential',
+						'name'        => 'client_id',
+						'label'       => __( 'User', 'forms-bridge' ),
+						'description' => __(
+							'Username of a Mautic user with API permissions. The API and the HTTP basic auth have to be enabled on the API Settings section of your Mautic configuration',
+							'forms-bridge'
+						),
+						'type'        => 'text',
+						'required'    => true,
+					),
+					array(
+						'ref'      => '#credential',
+						'name'     => 'client_secret',
+						'label'    => __( 'Password', 'forms-bridge' ),
+						'type'     => 'text',
+						'required' => true,
+					),
+					array(
+						'ref'   => '#bridge',
+						'name'  => 'method',
+						'value' => 'POST',
+					),
+				),
+				'bridge'     => array(
+					'method' => 'POST',
+				),
+				'backend'    => array(
+					'name'    => 'Mautic API',
+					'headers' => array(
+						array(
+							'name'  => 'Content-Type',
+							'value' => 'application/json',
+						),
+						array(
+							'name'  => 'Accept',
+							'value' => 'application/json',
+						),
+					),
+				),
+				'credential' => array(
+					'name'          => '',
+					'schema'        => 'Basic',
+					'client_id'     => '',
+					'client_secret' => '',
+				),
+			),
+			$defaults,
+			$schema
+		);
+	},
+	10,
+	3
+);
+
+add_filter(
+	'forms_bridge_template_data',
+	function ( $data, $template_id ) {
+		if ( strpos( $template_id, 'mautic-' ) !== 0 ) {
+			return $data;
+		}
+
+		$index = array_search(
+			'segments',
+			array_column( $data['bridge']['custom_fields'], 'name' ),
+			true,
+		);
+
+		if ( false !== $index ) {
+			$field = $data['bridge']['custom_fields'][ $index ];
+			$value = is_array( $field['value'] ) ? $field['value'] : array( $field['value'] );
+
+			array_splice( $data['bridge']['custom_fields'], $index, 1 );
+
+			$i = 0;
+			foreach ( $value as $segment_id ) {
+				if ( '' === $segment_id || null === $segment_id ) {
+					continue;
+				}
+
+				$data['bridge']['custom_fields'][] = array(
+					'name'  => "segments[{$i}]",
+					'value' => (int) $segment_id,
+				);
+
+				$data['bridge']['mutations'][0][] = array(
+					'from' => "segments[{$i}]",
+					'to'   => "segments[{$i}]",
+					'cast' => 'integer',
+				);
+
+				++$i;
+			}
+
+			$data['bridge']['custom_fields'] = array_values(
+				$data['bridge']['custom_fields']
+			);
+		}
+
+		return $data;
+	},
+	10,
+	2
+);
diff --git a/forms-bridge/addons/mautic/templates/contacts.php b/forms-bridge/addons/mautic/templates/contacts.php
new file mode 100644
index 00000000..1f95523b
--- /dev/null
+++ b/forms-bridge/addons/mautic/templates/contacts.php
@@ -0,0 +1,107 @@
+<?php
+/**
+ * Mautic addon contacts bridge template
+ *
+ * @package formsbridge
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit();
+}
+
+return array(
+	'title'       => __( 'Contacts', 'forms-bridge' ),
+	'description' => __(
+		'Contact form template. The resulting bridge will convert form submissions into Mautic contacts and, optionally, add them to segments.',
+		'forms-bridge'
+	),
+	'fields'      => array(
+		array(
+			'ref'   => '#bridge',
+			'name'  => 'endpoint',
+			'value' => '/api/contacts/new',
+		),
+		array(
+			'ref'   => '#bridge',
+			'name'  => 'method',
+			'value' => 'POST',
+		),
+		array(
+			'ref'         => '#bridge/custom_fields[]',
+			'name'        => 'segments',
+			'label'       => __( 'Segments', 'forms-bridge' ),
+			'description' => __(
+				'Segments the contacts will be added to',
+				'forms-bridge'
+			),
+			'type'        => 'select',
+			'options'     => array(
+				'endpoint' => '/api/segments',
+				'finger'   => array(
+					'value' => 'lists[].id',
+					'label' => 'lists[].name',
+				),
+			),
+			'is_multi'    => true,
+		),
+		array(
+			'ref'         => '#bridge/custom_fields[]',
+			'name'        => 'tags',
+			'label'       => __( 'Tags', 'forms-bridge' ),
+			'description' => __(
+				'Comma separated list of tags to assign to the contacts',
+				'forms-bridge'
+			),
+			'type'        => 'text',
+		),
+		array(
+			'ref'     => '#form',
+			'name'    => 'title',
+			'default' => __( 'Contacts', 'forms-bridge' ),
+		),
+	),
+	'form'        => array(
+		'title'  => __( 'Contacts', 'forms-bridge' ),
+		'fields' => array(
+			array(
+				'name'     => 'your-email',
+				'label'    => __( 'Your email', 'forms-bridge' ),
+				'type'     => 'email',
+				'required' => true,
+			),
+			array(
+				'name'  => 'your-first-name',
+				'label' => __( 'Your first name', 'forms-bridge' ),
+				'type'  => 'text',
+			),
+			array(
+				'name'  => 'your-last-name',
+				'label' => __( 'Your last name', 'forms-bridge' ),
+				'type'  => 'text',
+			),
+		),
+	),
+	'bridge'      => array(
+		'method'    => 'POST',
+		'endpoint'  => '/api/contacts/new',
+		'mutations' => array(
+			array(
+				array(
+					'from' => 'your-email',
+					'to'   => 'email',
+					'cast' => 'string',
+				),
+				array(
+					'from' => '?your-first-name',
+					'to'   => 'firstname',
+					'cast' => 'string',
+				),
+				array(
+					'from' => '?your-last-name',
+					'to'   => 'lastname',
+					'cast' => 'string',
+				),
+			),
+		),
+	),
+);
diff --git a/tests/addons/test-mautic.php b/tests/addons/test-mautic.php
new file mode 100644
index 00000000..4ab9661b
--- /dev/null
+++ b/tests/addons/test-mautic.php
@@ -0,0 +1,752 @@
+<?php
+/**
+ * Class MauticTest
+ *
+ * @package formsbridge-tests
+ */
+
+use FORMS_BRIDGE\Mautic_Form_Bridge;
+use FORMS_BRIDGE\Mautic_Addon;
+use FORMS_BRIDGE\Addon;
+use HTTP_BRIDGE\Backend;
+use HTTP_BRIDGE\Credential;
+
+/**
+ * Mautic test case.
+ */
+class MauticTest extends WP_UnitTestCase {
+
+	/**
+	 * Handles the intercepted http requests data.
+	 *
+	 * @var array
+	 */
+	private static $requests;
+
+	/**
+	 * Handles the mock responses to return, keyed by request path.
+	 *
+	 * @var array
+	 */
+	private static $mock_responses;
+
+	/**
+	 * Holds the mocked backend name.
+	 *
+	 * @var string
+	 */
+	private const BACKEND_NAME = 'test-mautic-backend';
+
+	/**
+	 * Holds the mocked backend base URL.
+	 *
+	 * @var string
+	 */
+	private const BACKEND_URL = 'https://mautic.example.coop';
+
+	/**
+	 * Holds the mocked credential name.
+	 *
+	 * @var string
+	 */
+	private const CREDENTIAL_NAME = 'test-mautic-credential';
+
+	/**
+	 * Holds the mocked bridge name.
+	 *
+	 * @var string
+	 */
+	private const BRIDGE_NAME = 'test-mautic-bridge';
+
+	/**
+	 * Test credential provider.
+	 *
+	 * @return Credential[]
+	 */
+	public static function credentials_provider() {
+		return array(
+			new Credential(
+				array(
+					'name'          => self::CREDENTIAL_NAME,
+					'schema'        => 'Basic',
+					'client_id'     => 'test-user',
+					'client_secret' => 'test-password',
+				)
+			),
+		);
+	}
+
+	/**
+	 * Test backend provider.
+	 *
+	 * @return Backend[]
+	 */
+	public static function backends_provider() {
+		return array(
+			new Backend(
+				array(
+					'name'       => self::BACKEND_NAME,
+					'base_url'   => self::BACKEND_URL,
+					'credential' => self::CREDENTIAL_NAME,
+					'headers'    => array(
+						array(
+							'name'  => 'Content-Type',
+							'value' => 'application/json',
+						),
+						array(
+							'name'  => 'Accept',
+							'value' => 'application/json',
+						),
+					),
+				)
+			),
+		);
+	}
+
+	/**
+	 * HTTP requests interceptor.
+	 *
+	 * @param mixed  $pre Initial pre hook value.
+	 * @param array  $args Request arguments.
+	 * @param string $url Request URL.
+	 *
+	 * @return array
+	 */
+	public static function pre_http_request( $pre, $args, $url ) {
+		$parsed_url = wp_parse_url( $url );
+		$path       = $parsed_url['path'] ?? '';
+		$method     = $args['method'] ?? 'POST';
+
+		$body = array();
+		if ( ! empty( $args['body'] ) ) {
+			$body = is_string( $args['body'] ) ? json_decode( $args['body'], true ) : $args['body'];
+		}
+
+		self::$requests[] = array(
+			'args'   => $args,
+			'url'    => $url,
+			'path'   => $path,
+			'method' => $method,
+			'body'   => $body,
+		);
+
+		$http = array(
+			'code'    => 200,
+			'message' => 'OK',
+		);
+
+		if ( isset( self::$mock_responses[ $path ] ) ) {
+			$response_body = self::$mock_responses[ $path ];
+			$http          = $response_body['http'] ?? $http;
+			unset( $response_body['http'] );
+		} else {
+			$response_body = self::get_mock_response( $path, $body );
+		}
+
+		return array(
+			'response'      => $http,
+			'headers'       => array( 'Content-Type' => 'application/json' ),
+			'cookies'       => array(),
+			'body'          => wp_json_encode( $response_body ),
+			'http_response' => null,
+		);
+	}
+
+	/**
+	 * Get mock response based on API endpoint.
+	 *
+	 * @param string $path API endpoint path.
+	 * @param array  $body Request body.
+	 *
+	 * @return array Mock response.
+	 */
+	private static function get_mock_response( $path, $body ) {
+		if ( preg_match( '/^\/api\/segments\/\d+\/contact\/\d+\/add$/', $path ) ) {
+			return array( 'success' => 1 );
+		}
+
+		switch ( $path ) {
+			case '/api/contacts/new':
+				return array(
+					'contact' => array(
+						'id'     => 47,
+						'fields' => array(
+							'all' => array(
+								'id'    => 47,
+								'email' => $body['email'] ?? null,
+							),
+						),
+					),
+				);
+			case '/api/contacts':
+				return array(
+					'total'    => '1',
+					'contacts' => array(
+						'47' => array(
+							'id' => 47,
+						),
+					),
+				);
+			case '/api/segments':
+				return array(
+					'total' => 2,
+					'lists' => array(
+						'3' => array(
+							'id'   => 3,
+							'name' => 'Newsletter',
+						),
+						'5' => array(
+							'id'   => 5,
+							'name' => 'Leads',
+						),
+					),
+				);
+			case '/api/fields/contact':
+				return array(
+					'total'  => 4,
+					'fields' => array(
+						array(
+							'id'          => 1,
+							'alias'       => 'email',
+							'type'        => 'email',
+							'isRequired'  => false,
+							'isPublished' => true,
+						),
+						array(
+							'id'          => 2,
+							'alias'       => 'firstname',
+							'type'        => 'text',
+							'isRequired'  => true,
+							'isPublished' => true,
+						),
+						array(
+							'id'          => 3,
+							'alias'       => 'points',
+							'type'        => 'number',
+							'isRequired'  => false,
+							'isPublished' => true,
+						),
+						array(
+							'id'          => 4,
+							'alias'       => 'legacy',
+							'type'        => 'text',
+							'isRequired'  => false,
+							'isPublished' => false,
+						),
+					),
+				);
+			default:
+				return array();
+		}
+	}
+
+	/**
+	 * Returns the intercepted requests to the given path.
+	 *
+	 * @param string $path Request path.
+	 *
+	 * @return array
+	 */
+	private static function requests_to( $path ) {
+		return array_values(
+			array_filter(
+				self::$requests,
+				function ( $request ) use ( $path ) {
+					return $request['path'] === $path;
+				}
+			)
+		);
+	}
+
+	/**
+	 * Returns the contact email used on the payloads.
+	 *
+	 * @return string
+	 */
+	private static function email() {
+		return sprintf( '%s@%s', 'john.doe', 'example.coop' );
+	}
+
+	/**
+	 * Returns a contact creation bridge.
+	 *
+	 * @return Mautic_Form_Bridge
+	 */
+	private static function contacts_bridge() {
+		return new Mautic_Form_Bridge(
+			array(
+				'name'     => self::BRIDGE_NAME,
+				'backend'  => self::BACKEND_NAME,
+				'endpoint' => '/api/contacts/new',
+				'method'   => 'POST',
+			)
+		);
+	}
+
+	/**
+	 * Set up test fixtures.
+	 */
+	public function set_up() {
+		parent::set_up();
+
+		self::$requests       = array();
+		self::$mock_responses = array();
+
+		tests_add_filter( 'http_bridge_credentials', array( self::class, 'credentials_provider' ), 10, 0 );
+		tests_add_filter( 'http_bridge_backends', array( self::class, 'backends_provider' ), 10, 0 );
+		tests_add_filter( 'pre_http_request', array( self::class, 'pre_http_request' ), 10, 3 );
+	}
+
+	/**
+	 * Tear down test filters.
+	 */
+	public function tear_down() {
+		remove_filter( 'http_bridge_credentials', array( self::class, 'credentials_provider' ), 10, 0 );
+		remove_filter( 'http_bridge_backends', array( self::class, 'backends_provider' ), 10, 0 );
+		remove_filter( 'pre_http_request', array( self::class, 'pre_http_request' ), 10, 3 );
+
+		parent::tear_down();
+	}
+
+	/**
+	 * Test that the addon class exists and has correct constants.
+	 */
+	public function test_addon_class_exists() {
+		$this->assertTrue( class_exists( 'FORMS_BRIDGE\Mautic_Addon' ) );
+		$this->assertEquals( 'Mautic', Mautic_Addon::TITLE );
+		$this->assertEquals( 'mautic', Mautic_Addon::NAME );
+		$this->assertEquals( '\FORMS_BRIDGE\Mautic_Form_Bridge', Mautic_Addon::BRIDGE );
+		$this->assertInstanceOf( Mautic_Addon::class, Addon::addon( 'mautic' ) );
+	}
+
+	/**
+	 * Test bridge validation with valid data.
+	 */
+	public function test_bridge_validation() {
+		$bridge = self::contacts_bridge();
+
+		$this->assertTrue( $bridge->is_valid );
+		$this->assertEquals( 'mautic', $bridge->addon );
+	}
+
+	/**
+	 * Test contact creation with basic auth.
+	 */
+	public function test_post_create_contact() {
+		$response = self::contacts_bridge()->submit(
+			array(
+				'email'     => self::email(),
+				'firstname' => 'John',
+			)
+		);
+
+		$this->assertFalse( is_wp_error( $response ) );
+		$this->assertEquals( 47, $response['data']['contact']['id'] );
+
+		$this->assertCount( 1, self::$requests );
+		$request = self::$requests[0];
+
+		$this->assertEquals( self::BACKEND_URL . '/api/contacts/new', $request['url'] );
+		$this->assertEquals( self::email(), $request['body']['email'] );
+		$this->assertEquals(
+			'Basic ' . base64_encode( 'test-user:test-password' ), // phpcs:ignore WordPress.PHP.DiscouragedPHPFunctions.obfuscation_base64_encode
+			$request['args']['headers']['Authorization']
+		);
+	}
+
+	/**
+	 * Test that the contact is added to each payload segment after its creation.
+	 */
+	public function test_post_create_contact_with_segments() {
+		$response = self::contacts_bridge()->submit(
+			array(
+				'email'    => self::email(),
+				'segments' => array( 3, '5', 3 ),
+			)
+		);
+
+		$this->assertFalse( is_wp_error( $response ) );
+
+		$contact_request = self::requests_to( '/api/contacts/new' )[0];
+		$this->assertArrayNotHasKey( 'segments', $contact_request['body'] );
+
+		$this->assertEquals(
+			array(
+				'/api/contacts/new',
+				'/api/segments/3/contact/47/add',
+				'/api/segments/5/contact/47/add',
+			),
+			array_column( self::$requests, 'path' )
+		);
+	}
+
+	/**
+	 * Test that the template custom fields reach the API as contact segments.
+	 */
+	public function test_custom_fields_segments() {
+		$bridge = new Mautic_Form_Bridge(
+			array(
+				'name'          => self::BRIDGE_NAME,
+				'backend'       => self::BACKEND_NAME,
+				'endpoint'      => '/api/contacts/new',
+				'method'        => 'POST',
+				'custom_fields' => array(
+					array(
+						'name'  => 'segments[0]',
+						'value' => '3',
+					),
+					array(
+						'name'  => 'segments[1]',
+						'value' => '5',
+					),
+				),
+				'mutations'     => array(
+					array(
+						array(
+							'from' => 'segments[0]',
+							'to'   => 'segments[0]',
+							'cast' => 'integer',
+						),
+						array(
+							'from' => 'segments[1]',
+							'to'   => 'segments[1]',
+							'cast' => 'integer',
+						),
+					),
+				),
+			)
+		);
+
+		$payload = $bridge->add_custom_fields( array( 'email' => self::email() ) );
+		$payload = $bridge->apply_mutation( $payload );
+
+		$this->assertSame( array( 3, 5 ), $payload['segments'] );
+
+		$response = $bridge->submit( $payload );
+
+		$this->assertFalse( is_wp_error( $response ) );
+		$this->assertEquals(
+			array(
+				'/api/contacts/new',
+				'/api/segments/3/contact/47/add',
+				'/api/segments/5/contact/47/add',
+			),
+			array_column( self::$requests, 'path' )
+		);
+	}
+
+	/**
+	 * Test that comma separated segments are supported.
+	 */
+	public function test_post_create_contact_with_csv_segments() {
+		$response = self::contacts_bridge()->submit(
+			array(
+				'email'    => self::email(),
+				'segments' => '3, 5',
+			)
+		);
+
+		$this->assertFalse( is_wp_error( $response ) );
+		$this->assertCount( 1, self::requests_to( '/api/segments/3/contact/47/add' ) );
+		$this->assertCount( 1, self::requests_to( '/api/segments/5/contact/47/add' ) );
+	}
+
+	/**
+	 * Test that empty segments does not perform segment requests.
+	 */
+	public function test_post_create_contact_without_segments() {
+		$response = self::contacts_bridge()->submit(
+			array(
+				'email'    => self::email(),
+				'segments' => array(),
+			)
+		);
+
+		$this->assertFalse( is_wp_error( $response ) );
+		$this->assertEquals( array( '/api/contacts/new' ), array_column( self::$requests, 'path' ) );
+		$this->assertArrayNotHasKey( 'segments', self::$requests[0]['body'] );
+	}
+
+	/**
+	 * Test that segments field is not removed from other endpoints payloads.
+	 */
+	public function test_segments_untouched_on_other_endpoints() {
+		$bridge = new Mautic_Form_Bridge(
+			array(
+				'name'     => self::BRIDGE_NAME,
+				'backend'  => self::BACKEND_NAME,
+				'endpoint' => '/api/companies/new',
+				'method'   => 'POST',
+			)
+		);
+
+		$response = $bridge->submit(
+			array(
+				'companyname' => 'Codec',
+				'segments'    => array( 3 ),
+			)
+		);
+
+		$this->assertFalse( is_wp_error( $response ) );
+		$this->assertCount( 1, self::$requests );
+		$this->assertEquals( array( 3 ), self::$requests[0]['body']['segments'] );
+	}
+
+	/**
+	 * Test segment error status codes are returned as errors.
+	 */
+	public function test_segment_error_response() {
+		self::$mock_responses['/api/segments/3/contact/47/add'] = array(
+			'http'   => array(
+				'code'    => 404,
+				'message' => 'Not Found',
+			),
+			'errors' => array(
+				array(
+					'code'    => 404,
+					'message' => 'Item was not found.',
+				),
+			),
+		);
+
+		$response = self::contacts_bridge()->submit(
+			array(
+				'email'    => self::email(),
+				'segments' => array( 3 ),
+			)
+		);
+
+		$this->assertTrue( is_wp_error( $response ) );
+	}
+
+	/**
+	 * Test unsuccessful segment responses are returned as errors.
+	 */
+	public function test_segment_unsuccessful_response() {
+		self::$mock_responses['/api/segments/3/contact/47/add'] = array( 'success' => 0 );
+
+		$response = self::contacts_bridge()->submit(
+			array(
+				'email'    => self::email(),
+				'segments' => array( 3 ),
+			)
+		);
+
+		$this->assertTrue( is_wp_error( $response ) );
+		$this->assertEquals( 'mautic_segments_error', $response->get_error_code() );
+	}
+
+	/**
+	 * Test contact creation errors skip segment requests.
+	 */
+	public function test_error_response_handling() {
+		self::$mock_responses['/api/contacts/new'] = array(
+			'http'   => array(
+				'code'    => 401,
+				'message' => 'Unauthorized',
+			),
+			'errors' => array(
+				array(
+					'code'    => 401,
+					'message' => 'API authorization denied.',
+				),
+			),
+		);
+
+		$response = self::contacts_bridge()->submit(
+			array(
+				'email'    => self::email(),
+				'segments' => array( 3 ),
+			)
+		);
+
+		$this->assertTrue( is_wp_error( $response ) );
+		$this->assertCount( 1, self::$requests );
+	}
+
+	/**
+	 * Test errors reported with a success status code.
+	 */
+	public function test_error_body_with_success_status() {
+		self::$mock_responses['/api/contacts/new'] = array(
+			'errors' => array(
+				array(
+					'code'    => 400,
+					'message' => 'email: A valid email is required.',
+				),
+			),
+		);
+
+		$response = self::contacts_bridge()->submit( array( 'email' => 'invalid' ) );
+
+		$this->assertTrue( is_wp_error( $response ) );
+		$this->assertEquals( 'mautic_api_error', $response->get_error_code() );
+	}
+
+	/**
+	 * Test invalid backend handling.
+	 */
+	public function test_invalid_backend() {
+		$bridge = new Mautic_Form_Bridge(
+			array(
+				'name'     => 'test-invalid-backend-bridge',
+				'backend'  => 'non-existent-backend',
+				'endpoint' => '/api/contacts/new',
+				'method'   => 'POST',
+			)
+		);
+
+		$response = $bridge->submit( array( 'segments' => array( 3 ) ) );
+
+		$this->assertTrue( is_wp_error( $response ) );
+		$this->assertEquals( 'invalid_backend', $response->get_error_code() );
+	}
+
+	/**
+	 * Test that collections indexed by ID are returned as lists.
+	 */
+	public function test_get_segments_as_list() {
+		$response = Addon::addon( 'mautic' )->fetch( '/api/segments', self::BACKEND_NAME );
+
+		$this->assertFalse( is_wp_error( $response ) );
+		$this->assertTrue( wp_is_numeric_array( $response['data']['lists'] ) );
+
+		$finger = new FORMS_BRIDGE\JSON_Finger( $response['data'] );
+		$this->assertEquals( array( 3, 5 ), $finger->get( 'lists[].id' ) );
+		$this->assertEquals( array( 'Newsletter', 'Leads' ), $finger->get( 'lists[].name' ) );
+	}
+
+	/**
+	 * Test addon ping method.
+	 */
+	public function test_addon_ping() {
+		$this->assertTrue( Addon::addon( 'mautic' )->ping( self::BACKEND_NAME ) );
+
+		$this->assertEquals( '/api/contacts', self::$requests[0]['path'] );
+		$this->assertEquals( 'GET', self::$requests[0]['method'] );
+	}
+
+	/**
+	 * Test addon ping method on error.
+	 */
+	public function test_addon_ping_error() {
+		self::$mock_responses['/api/contacts'] = array(
+			'http' => array(
+				'code'    => 403,
+				'message' => 'Forbidden',
+			),
+		);
+
+		$this->assertFalse( Addon::addon( 'mautic' )->ping( self::BACKEND_NAME ) );
+	}
+
+	/**
+	 * Test addon get_endpoints method.
+	 */
+	public function test_addon_get_endpoints() {
+		$addon = Addon::addon( 'mautic' );
+
+		$this->assertContains( '/api/contacts/new', $addon->get_endpoints( self::BACKEND_NAME ) );
+		$this->assertContains( '/api/segments', $addon->get_endpoints( self::BACKEND_NAME ) );
+		$this->assertEquals(
+			array( '/api/contacts/new', '/api/companies/new' ),
+			$addon->get_endpoints( self::BACKEND_NAME, 'POST' )
+		);
+		$this->assertNotContains( '/api/contacts/new', $addon->get_endpoints( self::BACKEND_NAME, 'get' ) );
+	}
+
+	/**
+	 * Test addon get_endpoint_schema method.
+	 */
+	public function test_addon_get_endpoint_schema() {
+		$schema = Addon::addon( 'mautic' )->get_endpoint_schema(
+			'/api/contacts/new',
+			self::BACKEND_NAME,
+			'POST'
+		);
+
+		$fields = array();
+		foreach ( $schema as $field ) {
+			$fields[ $field['name'] ] = $field;
+		}
+
+		$this->assertArrayHasKey( 'email', $fields );
+		$this->assertArrayHasKey( 'firstname', $fields );
+		$this->assertTrue( $fields['firstname']['required'] );
+		$this->assertEquals( 'number', $fields['points']['schema']['type'] );
+		$this->assertArrayNotHasKey( 'legacy', $fields );
+		$this->assertArrayHasKey( 'segments', $fields );
+		$this->assertArrayHasKey( 'tags', $fields );
+
+		$this->assertEquals( '/api/fields/contact', self::$requests[0]['path'] );
+	}
+
+	/**
+	 * Test addon get_endpoint_schema method for unknown endpoints.
+	 */
+	public function test_addon_get_endpoint_schema_unknown() {
+		$addon = Addon::addon( 'mautic' );
+
+		$this->assertEquals( array(), $addon->get_endpoint_schema( '/api/unknown', self::BACKEND_NAME, 'POST' ) );
+		$this->assertEquals( array(), $addon->get_endpoint_schema( '/api/contacts/new', self::BACKEND_NAME, 'GET' ) );
+		$this->assertEmpty( self::$requests );
+	}
+
+	/**
+	 * Test that the template segments are expanded as integer custom fields.
+	 */
+	public function test_template_data_segments() {
+		$data = array(
+			'bridge' => array(
+				'custom_fields' => array(
+					array(
+						'name'  => 'segments',
+						'value' => array( '3', '5' ),
+					),
+					array(
+						'name'  => 'tags',
+						'value' => 'web',
+					),
+				),
+				'mutations'     => array( array() ),
+			),
+		);
+
+		$data = apply_filters( 'forms_bridge_template_data', $data, 'mautic-contacts' );
+
+		$this->assertEquals(
+			array(
+				array(
+					'name'  => 'tags',
+					'value' => 'web',
+				),
+				array(
+					'name'  => 'segments[0]',
+					'value' => 3,
+				),
+				array(
+					'name'  => 'segments[1]',
+					'value' => 5,
+				),
+			),
+			$data['bridge']['custom_fields']
+		);
+
+		$this->assertEquals( 'segments[1]', $data['bridge']['mutations'][0][1]['to'] );
+		$this->assertEquals( 'integer', $data['bridge']['mutations'][0][1]['cast'] );
+	}
+
+	/**
+	 * Test that the contacts template is registered and valid.
+	 */
+	public function test_contacts_template() {
+		$data         = include FORMS_BRIDGE_ADDONS_DIR . '/mautic/templates/contacts.php';
+		$data['name'] = 'contacts';
+
+		$template = new FORMS_BRIDGE\Form_Bridge_Template( $data, 'mautic' );
+
+		$this->assertTrue( $template->is_valid );
+		$this->assertEquals( '/api/contacts/new', $template->bridge['endpoint'] );
+		$this->assertEquals( 'Basic', $template->credential['schema'] );
+	}
+}