Mautic's API enables you to build custom integrations and applications on top of Mautic. This means you can connect Mautic to other tools in your tech stack, automate processes, or even build your own Mautic-powered app.
Here are a few examples of what you can build using the Mautic API:
import { axios } from "@pipedream/platform"
export default defineComponent({
props: {
mautic: {
type: "app",
app: "mautic",
}
},
async run({steps, $}) {
return await axios($, {
url: `${this.mautic.$auth.mautic_url}/api/users/self`,
headers: {
Authorization: `Bearer ${this.mautic.$auth.oauth_access_token}`,
},
})
},
})
Mautic uses OAuth authentication. When you connect your Mautic account, Pipedream will open a popup window where you can sign into Mautic and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any Mautic API.
Pipedream requests the following authorization scopes when you connect your account:
GET
{{custom_fields.mautic_url}}/oauth/v2/authorize
?
client_id={{custom_fields.client_id}}
&
redirect_uri={{oauth.redirect_uri}}
&
state={{oauth.state}}
&
response_type=code
&
scope={{oauth.space_separated_scopes}}
POST
{{custom_fields.mautic_url}}/oauth/v2/token
content-type: application/x-www-form-urlencoded
accept: application/json
client_id={{custom_fields.client_id}}
&
client_secret={{custom_fields.client_secret}}
&
redirect_uri={{oauth.redirect_uri}}
&
grant_type=authorization_code
&
code={{oauth.code}}
POST
{{custom_fields.mautic_url}}/oauth/v2/token
content-type: application/x-www-form-urlencoded
accept: application/json
client_id={{custom_fields.client_id}}
&
client_secret={{custom_fields.client_secret}}
&
grant_type=refresh_token
&
refresh_token={{oauth.refresh_token}}