Magnétis API

Introduction

Base URL: https://api.magnetis.io

This documentation aims to provide all the information you need to work with our API. Please refer to our documentation How to start with the Magnetis API ?

Authenticating requests

To authenticate requests, include a x-api-key header with the value "{YOUR_AUTH_KEY}".

All authenticated endpoints are marked with a requires authentication badge in the documentation below.

You can retrieve your token by visiting your dashboard and clicking Generate API token.

Alerts

Email alerts

List all email alerts

GET

https://api.magnetis.io

/alerts/email

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

account_id

Optional. Filter by account ID.

Example:

acc-XXX

limit

Optional. Result per page. 250 if not set.

Example:

250

page

Optional. Pagination page. 1 if not set.

Example:

Response Fields

string

The unique ID of the email alert

account

object

Account linked to the alert

created_at

datetime

Alert creation date. Format: YYYY-MM-DD HH:mm:ss

enabled

boolean

Active status of the alert

less_than

interger

Call duration in seconds from which not to send an alert. For custom_alert only. Cannot be used with more_than.

more_than

interger

Call duration in seconds from which to send an alert. For custom_alert only. Cannot be used with less_than.

recipients

string[]

Array of emails the alert will be sent to

title

string

Alert title

type

string

Alert type. Enum: all_calls,lost_calls,custom_calls

Example request:

curl --request GET \
    --get "https://api.magnetis.io/alerts/email" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [
        {
            "id": "ale-b098cb40-c57b-4a2b-bf5c-70348741ed91",
            "account": {
                "id": "acc-f27c03a5-9498-4dd1-aeeb-30722b219f2e",
                "name": "Immobilier tertiaire"
            },
            "created_at": "2024-03-04 09:06:09",
            "enabled": 1,
            "less_than": 23,
            "more_than": null,
            "recipients": [
                "example@email.fr"
            ],
            "title": "Alerte sur appel personnalisé",
            "type": "custom_calls"
        },
        {
            "id": "acc-f27c03a5-9498-4dd1-aeeb-30722b219f2e",
            "account": {
                "id": "acc-6a29eed8-af46-4a4c-bd4b-e4d44f7b345f",
                "name": "Immobilier tertiaire"
            },
            "created_at": "2024-03-04 09:06:10",
            "enabled": 1,
            "less_than": null,
            "more_than": null,
            "recipients": [
                "example@email.fr"
            ],
            "title": "Alerte sur appel manqué",
            "type": "lost_calls"
        },
        {
            "id": "ale-5f695e85-1508-4365-9ade-56ab6d9b861a",
            "account": {
                "id": "acc-f27c03a5-9498-4dd1-aeeb-30722b219f2e",
                "name": "Immobilier tertiaire"
            },
            "created_at": "2024-03-04 09:06:10",
            "enabled": 1,
            "less_than": null,
            "more_than": null,
            "recipients": [
                "example@email.fr"
            ],
            "title": "Alerte sur tous les appels",
            "type": "all_calls"
        }
    ],
    "links": {
        "first": "https://api.magnetis.io/alerts/email?page=1",
        "last": "https://api.magnetis.io/alerts/email?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "path": "https://api.magnetis.io/alerts/email",
        "per_page": 250,
        "to": 3,
        "total": 3,
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "account",
            "name": "My account"
        }
    }
}

Create an email alert

POST

https://api.magnetis.io

/alerts/email

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

Body Parameters

account_id

string

required

The ID of the account which should contain the alert.

Example:

acc-6e64b651-026a-46de-ab3e-944a193945a9

title

string

required

The title of the alert

Example:

Alerte sur appel manqué

type

string

required

The type of the alert.
Can be: all_calls,custom_calls,lost_calls

Example:

custom_calls

more_than

integer

Call duration in seconds from which not to send an alert.
For custom_alert only. Cannot be used with more_than.

Example:

less_than

integer

Call duration in seconds from which to send an alert.
For custom_alert only. Cannot be used with less_than.

enabled

boolean

required

Determines if the alert is active

recipients

string[]

required

List of emails to receive the alert

Example:

["amazingemail@email.com","thebestemail@email.com"]

Response Fields

string

The unique ID of the email alert

account

object

Account linked to the alert

created_at

datetime

Alert creation date. Format: YYYY-MM-DD HH:mm:ss

enabled

boolean

Active status of the alert

less_than

interger

Call duration in seconds from which not to send an alert. For custom_alert only. Cannot be used with more_than.

more_than

interger

Call duration in seconds from which to send an alert. For custom_alert only. Cannot be used with less_than.

recipients

string[]

Array of emails the alert will be sent to

title

string

Alert title

type

string

Alert type. Enum: all_calls,lost_calls,custom_calls

Example request:

curl --request POST \
    "https://api.magnetis.io/alerts/email" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"account_id\": \"acc-6e64b651-026a-46de-ab3e-944a193945a9\",
    \"title\": \"Alerte sur appel manqué\",
    \"type\": \"custom_calls\",
    \"more_than\": 20,
    \"less_than\": \"\",
    \"enabled\": false,
    \"recipients\": [
        \"amazingemail@email.com\",
        \"thebestemail@email.com\"
    ]
}"

Example response:

{
    "data": {
        "id": "ale-b098cb40-c57b-4a2b-bf5c-70348741ed91",
        "account": {
            "id": "acc-f27c03a5-9498-4dd1-aeeb-30722b219f2e",
            "name": "Immobilier tertiaire"
        },
        "created_at": "2024-03-04 09:06:09",
        "enabled": 1,
        "less_than": 23,
        "more_than": null,
        "recipients": [
            "example@email.fr"
        ],
        "title": "Alerte sur appel personnalisé",
        "type": "custom_calls"
    },
    "meta": {
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2024-03-04 09:12:08",
            "expiration": null,
            "level": "account",
            "name": "My account"
        },
        "total": 3
    }
}

Fetch an email alert

GET

https://api.magnetis.io

/alerts/email/{id}

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

string

required

The id of the alert.

Example:

ale-06529b90-73e1-4f8d-b654-aa1f8116ab41

Response Fields

string

The unique ID of the email alert

account

object

Account linked to the alert

created_at

datetime

Alert creation date. Format: YYYY-MM-DD HH:mm:ss

enabled

boolean

Active status of the alert

less_than

interger

Call duration in seconds from which not to send an alert. For custom_alert only. Cannot be used with more_than.

more_than

interger

Call duration in seconds from which to send an alert. For custom_alert only. Cannot be used with less_than.

recipients

string[]

Array of emails the alert will be sent to

title

string

Alert title

type

string

Alert type. Enum: all_calls,lost_calls,custom_calls

Example request:

curl --request GET \
    --get "https://api.magnetis.io/alerts/email/ale-06529b90-73e1-4f8d-b654-aa1f8116ab41" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": {
        "id": "ale-b098cb40-c57b-4a2b-bf5c-70348741ed91",
        "account": {
            "id": "acc-f27c03a5-9498-4dd1-aeeb-30722b219f2e",
            "name": "Immobilier tertiaire"
        },
        "created_at": "2024-03-04 09:06:09",
        "enabled": 1,
        "less_than": 23,
        "more_than": null,
        "recipients": [
            "example@email.fr"
        ],
        "title": "Alerte sur appel personnalisé",
        "type": "custom_calls"
    },
    "meta": {
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2024-03-04 09:12:08",
            "expiration": null,
            "level": "account",
            "name": "My account"
        },
        "total": 3
    }
}

Update an email alert

PUT

PATCH

https://api.magnetis.io

/alerts/email/{id}

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

string

required

The ID of the alert.

Example:

ale-06529b90-73e1-4f8d-b654-aa1f8116ab41

Body Parameters

title

string

required

The title of the alert

Example:

Alerte sur appel manqué

type

string

required

The type of the alert.
Can be: all_calls,custom_calls,lost_calls

Example:

custom_calls

more_than

integer

Call duration in seconds from which not to send an alert.
For custom_alert only. Cannot be used with more_than.

Example:

less_than

integer

Call duration in seconds from which to send an alert.
For custom_alert only. Cannot be used with less_than.

enabled

boolean

required

Determines if the alert is active

recipients

string[]

required

List of emails to receive the alert

Example:

["amazingemail@email.com","thebestemail@email.com"]

Response Fields

string

The unique ID of the email alert

account

object

Account linked to the alert

created_at

datetime

Alert creation date. Format: YYYY-MM-DD HH:mm:ss

enabled

boolean

Active status of the alert

less_than

interger

Call duration in seconds from which not to send an alert. For custom_alert only. Cannot be used with more_than.

more_than

interger

Call duration in seconds from which to send an alert. For custom_alert only. Cannot be used with less_than.

recipients

string[]

Array of emails the alert will be sent to

title

string

Alert title

type

string

Alert type. Enum: all_calls,lost_calls,custom_calls

Example request:

curl --request PUT \
    "https://api.magnetis.io/alerts/email/ale-06529b90-73e1-4f8d-b654-aa1f8116ab41" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"title\": \"Alerte sur appel manqué\",
    \"type\": \"custom_calls\",
    \"more_than\": 20,
    \"less_than\": \"\",
    \"enabled\": false,
    \"recipients\": [
        \"amazingemail@email.com\",
        \"thebestemail@email.com\"
    ]
}"

Example response:

{
    "data": {
        "id": "ale-b098cb40-c57b-4a2b-bf5c-70348741ed91",
        "account": {
            "id": "acc-f27c03a5-9498-4dd1-aeeb-30722b219f2e",
            "name": "Immobilier tertiaire"
        },
        "created_at": "2024-03-04 09:06:09",
        "enabled": 1,
        "less_than": 23,
        "more_than": null,
        "recipients": [
            "example@email.fr"
        ],
        "title": "Alerte sur appel personnalisé",
        "type": "custom_calls"
    },
    "meta": {
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2024-03-04 09:12:08",
            "expiration": null,
            "level": "account",
            "name": "My account"
        },
        "total": 3
    }
}

Delete an email alert

DELETE

https://api.magnetis.io

/alerts/email/{id}

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

string

required

The ID of the alert.

Example:

ale-06529b90-73e1-4f8d-b654-aa1f8116ab41

Response Fields

string

The unique ID of the email alert

account

object

Account linked to the alert

created_at

datetime

Alert creation date. Format: YYYY-MM-DD HH:mm:ss

enabled

boolean

Active status of the alert

less_than

interger

Call duration in seconds from which not to send an alert. For custom_alert only. Cannot be used with more_than.

more_than

interger

Call duration in seconds from which to send an alert. For custom_alert only. Cannot be used with less_than.

recipients

string[]

Array of emails the alert will be sent to

title

string

Alert title

type

string

Alert type. Enum: all_calls,lost_calls,custom_calls

Example request:

curl --request DELETE \
    "https://api.magnetis.io/alerts/email/ale-06529b90-73e1-4f8d-b654-aa1f8116ab41" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [],
    "meta": {
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "account",
            "name": "My account"
        },
        "total": 0
    }
}

SMS alerts

List all SMS alerts

GET

https://api.magnetis.io

/alerts/sms

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

account_id

Optional. Filter by account ID.

Example:

acc-XXX

limit

Optional. Result per page. 250 if not set.

Example:

250

page

Optional. Pagination page. 1 if not set.

Example:

Response Fields

string

The unique ID of the alert

account

object

Account linked to the alert

additional_recipients

string[]

When type is 'called', you can provide additional sms recipients

all_tracked_numbers

boolean

Defines if all numbers need to be impacted

created_at

datetime

Creation datetime. Format: YYYY-MM-DD HH:mm:ss

enabled

boolean

Defines if the alert is actived or not

landing_page

string

ID of the Landing from the Studio

less_than

integer

Used with the type 'custom_calls', it defines the time before not sending the alert. Can't be set with 'more_than'

more_than

integer

Used with the type 'custom_calls', it defines the time before sending the alert. Can't be set with 'less_than'

notification_emails

string[]

Array of email who will receive an email alert when a new lead is created from the landing page. Used with landing_page

notification_recipients

string[]

Array of recipient who will receive an sms alert when a new lead is created from the landing page. Used with landing_page

numbers

string[]

Array of number ID linked to the alert. Cannot be used with 'all_tracked_numbers'

pools

string[]

Array of pool ID linked to the alert. Cannot be used with 'all_tracked_numbers'

send_to

string

Defines who receive the SMS. Enum: called, caller

sms_template

object

SMS template from the Studio

title

string

Alert title

type

string

Defines which type of call the SMS is sent on. Enum: lost_calls, custom_calls, all_calls

Example request:

curl --request GET \
    --get "https://api.magnetis.io/alerts/sms" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [
        {
            "id": "als-cccd40bf-3e4d-42fb-ad5a-76040aa03171",
            "account": {
                "id": "acc-f27c03a5-9498-4dd1-aeeb-30722b219f2e",
                "name": "Immobilier tertiaire"
            },
            "additional_recipients": [
                "rcp-bde9497b-ffe6-45db-8ffc-cd62b4260a59"
            ],
            "all_tracked_numbers": 0,
            "created_at": "2024-03-01 14:52:44",
            "enabled": 1,
            "landing_page": null,
            "less_than": null,
            "more_than": null,
            "notification_emails": [],
            "notification_recipients": [],
            "numbers": [],
            "pools": [],
            "send_to": "caller",
            "sms_template": {
                "id": "sds-a1cc1722-271e-4eb4-b66a-012cb7f3f244",
                "account": {
                    "id": "acc-51ce00db-b50b-4b3d-ad4d-9b19155d46b5",
                    "name": "Immobilier tertiaire"
                },
                "created_at": "2024-03-01 14:52:46",
                "entity": null,
                "from": "InfoAppel",
                "network": null,
                "nb_characters": null,
                "nb_sms": null,
                "text": "Bonjour, merci pour votre appel. Nous sommes actuellement indisponibles, mais vous pouvez nous joindre via notre site internet, www.monsite.fr. A très vite!",
                "title": "Appel Manqué Appelant",
                "user": {
                    "id": "usr-78a51d97-1bd2-467e-b67c-bb683014e84c",
                    "created_at": "2024-03-01T13:52:43.000000Z",
                    "email": "John.Doe@email.fr",
                    "firstname": "John",
                    "lang": "fr",
                    "lastname": "Doe",
                    "phone": "06 38 39 XX XX"
                }
            },
            "title": "Alerte par sms",
            "type": "lost_calls"
        },
        {
            "id": "als-88530b44-7887-4747-88d7-e5da1955ebac",
            "account": {
                "id": "acc-f27c03a5-9498-4dd1-aeeb-30722b219f2e",
                "name": "Immobilier tertiaire"
            },
            "additional_recipients": [
                "rcp-bde9497b-ffe6-45db-8ffc-cd62b4260a59"
            ],
            "all_tracked_numbers": 0,
            "created_at": "2024-03-01 14:52:44",
            "enabled": 1,
            "landing_page": null,
            "less_than": null,
            "more_than": null,
            "notification_emails": [],
            "notification_recipients": [],
            "numbers": [],
            "pools": [],
            "send_to": "caller",
            "sms_template": {
                "id": "sds-a1cc1722-271e-4eb4-b66a-012cb7f3f244",
                "account": {
                    "id": "acc-51ce00db-b50b-4b3d-ad4d-9b19155d46b5",
                    "name": "Immobilier tertiaire"
                },
                "created_at": "2024-03-01 14:52:46",
                "entity": null,
                "from": "InfoAppel",
                "network": null,
                "nb_characters": null,
                "nb_sms": null,
                "text": "Bonjour, merci pour votre appel. Nous sommes actuellement indisponibles, mais vous pouvez nous joindre via notre site internet, www.monsite.fr. A très vite!",
                "title": "Appel Manqué Appelant",
                "user": {
                    "id": "usr-78a51d97-1bd2-467e-b67c-bb683014e84c",
                    "created_at": "2024-03-01T13:52:43.000000Z",
                    "email": "John.Doe@email.fr",
                    "firstname": "John",
                    "lang": "fr",
                    "lastname": "Doe",
                    "phone": "06 38 39 XX XX"
                }
            },
            "title": "Alerte par sms",
            "type": "lost_calls"
        },
        {
            "id": "als-2a709bdd-f7e2-45bd-a86b-12633de528ec",
            "account": {
                "id": "acc-f27c03a5-9498-4dd1-aeeb-30722b219f2e",
                "name": "Immobilier tertiaire"
            },
            "additional_recipients": [
                "rcp-2765bc4d-9f7f-4324-8c83-11262bb4c0fd"
            ],
            "all_tracked_numbers": 0,
            "created_at": "2024-03-01 14:52:44",
            "enabled": 1,
            "landing_page": null,
            "less_than": null,
            "more_than": null,
            "notification_emails": [],
            "notification_recipients": [],
            "numbers": [],
            "pools": [],
            "send_to": "caller",
            "sms_template": {
                "id": "sds-a1cc1722-271e-4eb4-b66a-012cb7f3f244",
                "account": {
                    "id": "acc-51ce00db-b50b-4b3d-ad4d-9b19155d46b5",
                    "name": "Immobilier tertiaire"
                },
                "created_at": "2024-03-01 14:52:46",
                "entity": null,
                "from": "InfoAppel",
                "network": null,
                "nb_characters": null,
                "nb_sms": null,
                "text": "Bonjour, merci pour votre appel. Nous sommes actuellement indisponibles, mais vous pouvez nous joindre via notre site internet, www.monsite.fr. A très vite!",
                "title": "Appel Manqué Appelant",
                "user": {
                    "id": "usr-78a51d97-1bd2-467e-b67c-bb683014e84c",
                    "created_at": "2024-03-01T13:52:43.000000Z",
                    "email": "John.Doe@email.fr",
                    "firstname": "John",
                    "lang": "fr",
                    "lastname": "Doe",
                    "phone": "06 38 39 XX XX"
                }
            },
            "title": "Alerte par sms",
            "type": "lost_calls"
        },
        {
            "id": "als-f3f2849a-e306-4a00-b539-45bc48b95b61",
            "account": {
                "id": "acc-f27c03a5-9498-4dd1-aeeb-30722b219f2e",
                "name": "Immobilier tertiaire"
            },
            "additional_recipients": [],
            "all_tracked_numbers": 1,
            "created_at": "2024-03-07 10:34:09",
            "enabled": 1,
            "landing_page": {
                "id": "8810c59a-c05c-4801-a3e7-c77308296c9c",
                "account": {
                    "id": "acc-f27c03a5-9498-4dd1-aeeb-30722b219f2e",
                    "name": "Immobilier tertiaire"
                },
                "created_at": "2024-01-01 01:00:00",
                "entity": null,
                "network": null,
                "title": "Ma Landing Page",
                "url": "https://www.mywebsite.fr"
            },
            "less_than": null,
            "more_than": null,
            "notification_emails": [],
            "notification_recipients": [],
            "numbers": [],
            "pools": [],
            "send_to": "caller",
            "sms_template": {
                "id": "sds-3712da26-d91e-4d9a-8545-2a6a4023231b32",
                "account": {
                    "id": "acc-f27c03a5-9498-4dd1-aeeb-30722b219f2e",
                    "name": "Immobilier tertiaire"
                },
                "created_at": "2024-03-01 14:52:46",
                "entity": null,
                "from": "InfoAppel",
                "network": null,
                "nb_characters": 2121,
                "nb_sms": 2,
                "text": "Nous avons raté votre appel, completer le question ##LIENTRACKEVERSLANDPAGE## pour que nous puissions vous recontacter. A bientôt.",
                "title": "Appel Manqué Appelé",
                "user": {
                    "id": "usr-78a51d97-1bd2-467e-b67c-bb683014e84c",
                    "created_at": "2024-03-01 14:52:43",
                    "email": "John.Doe@email.fr",
                    "firstname": "John",
                    "lang": "fr",
                    "lastname": "Doe",
                    "phone": "06 38 39 XX XX"
                }
            },
            "title": "Sms de landing page",
            "type": "lost_calls"
        }
    ],
    "links": {
        "first": "https://api.magnetis.io/alerts/sms?page=1",
        "last": "https://api.magnetis.io/alerts/sms?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "path": "https://api.magnetis.io/alerts/sms",
        "per_page": 250,
        "to": 4,
        "total": 4,
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "account",
            "name": "My account"
        }
    }
}

Create a SMS alert

POST

https://api.magnetis.io

/alerts/sms

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

string

required

The unique ID of the alert.

Example:

als-06529b90-73e1-4f8d-b654-aa1f8116ab41

Body Parameters

additional_recipients

Additional Recipient IDs to the alert when 'send_to' equals to called

all_tracked_numbers

boolean

Defines if it's active on all numbers and pools and on selected numbers and/or pools

enabled

boolean

required

Defines if the alert is actived or not

landing_page_id

string

Used if your sms template have the landing page variable inside content.
The variable will be replace with a shortlink of the landing page url

Example:

ldp-53470c4d-7721-4490-bd22-237066afd5c5

less_than

integer

Used when type is custom_calls and more_than is not set.
Represent how many second the call must not exceed in duration before thinking of send the alert

Example:

more_than

integer

Used when type is custom_calls and less_than is not set.
Represent how many second the call must have in duration before thinking of send the alert

Example:

notification_emails

string[]

Array of email who will receive an email alert when a new lead is created from the landing page. Used with landing_page.

Example:

["amazingemail@email.com","thebestemail@email.com"]

notification_recipients

string[]

Array of recipient who will receive an sms alert when a new lead is created from the landing page. Used with landing_page.

Example:

["rcp-8b514c55-f135-48da-83e4-1a1cd3cccb84","rcp-75e932ca-6714-4088-b571-e6047a0dd1c6"]

numbers

string[]

List of number_id on which activated the alert

Example:

["num-50700e9e-879e-480a-859a-1db8301bd712","num-87b2e273-29c7-41a9-bd7e-66748d9cdf40"]

pools

string[]

List of pool_id on which activated the alert

Example:

["pul-50700e9e-879e-480a-859a-1db8301bd712","pul-87b2e273-29c7-41a9-bd7e-66748d9cdf40"]

send_to

string

Sms sent to Caller or Called number if mobile
Enum: caller or called

Example:

caller

sms_template_id

string

required

SMS template fron the studio

Example:

sds-8dc0d51c-bd63-4aaf-ab64-6fb46edb17ac

title

string

required

Alert Title

Example:

Alerte avec Landing Page

type

string

required

Type of the alert.
Can be: lost_calls, custom_calls or all_calls

Example:

custom_calls

account_id

string

Account ID you want to link this alert

Example:

acc-6e64b651-026a-46de-ab3e-944a193945a9

Response Fields

string

The unique ID of the alert

account

object

Account linked to the alert

additional_recipients

string[]

When type is 'called', you can provide additional sms recipients

all_tracked_numbers

boolean

Defines if all numbers need to be impacted

created_at

datetime

Creation datetime. Format: YYYY-MM-DD HH:mm:ss

enabled

boolean

Defines if the alert is actived or not

landing_page

string

ID of the Landing from the Studio

less_than

integer

Used with the type 'custom_calls', it defines the time before not sending the alert. Can't be set with 'more_than'

more_than

integer

Used with the type 'custom_calls', it defines the time before sending the alert. Can't be set with 'less_than'

notification_emails

string[]

Array of email who will receive an email alert when a new lead is created from the landing page. Used with landing_page

notification_recipients

string[]

Array of recipient who will receive an sms alert when a new lead is created from the landing page. Used with landing_page

numbers

string[]

Array of number ID linked to the alert. Cannot be used with 'all_tracked_numbers'

pools

string[]

Array of pool ID linked to the alert. Cannot be used with 'all_tracked_numbers'

send_to

string

Defines who receive the SMS. Enum: called, caller

sms_template

object

SMS template from the Studio

title

string

Alert title

type

string

Defines which type of call the SMS is sent on. Enum: lost_calls, custom_calls, all_calls

Example request:

curl --request POST \
    "https://api.magnetis.io/alerts/sms" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"additional_recipients\": false,
    \"all_tracked_numbers\": false,
    \"enabled\": null,
    \"landing_page_id\": \"ldp-53470c4d-7721-4490-bd22-237066afd5c5\",
    \"less_than\": 15,
    \"more_than\": 6,
    \"notification_emails\": [
        \"amazingemail@email.com\",
        \"thebestemail@email.com\"
    ],
    \"notification_recipients\": [
        \"rcp-8b514c55-f135-48da-83e4-1a1cd3cccb84\",
        \"rcp-75e932ca-6714-4088-b571-e6047a0dd1c6\"
    ],
    \"numbers\": [
        \"num-50700e9e-879e-480a-859a-1db8301bd712\",
        \"num-87b2e273-29c7-41a9-bd7e-66748d9cdf40\"
    ],
    \"pools\": [
        \"pul-50700e9e-879e-480a-859a-1db8301bd712\",
        \"pul-87b2e273-29c7-41a9-bd7e-66748d9cdf40\"
    ],
    \"send_to\": \"caller\",
    \"sms_template_id\": \"sds-8dc0d51c-bd63-4aaf-ab64-6fb46edb17ac\",
    \"title\": \"Alerte avec Landing Page\",
    \"type\": \"custom_calls\",
    \"account_id\": \"acc-6e64b651-026a-46de-ab3e-944a193945a9\"
}"

Example response:

Headers

                                                            cache-control
                                                            : no-cache, private
                                                                                                                    content-type
                                                            : application/json
                                                                                                                    x-ratelimit-limit
                                                            : 600
                                                                                                                    x-ratelimit-remaining
                                                            : 593

{
    "error": "Api key is invalid",
    "data": []
}

Fetch a SMS alert

GET

https://api.magnetis.io

/alerts/sms/{id}

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

string

required

The id of the alert.

Example:

als-06529b90-73e1-4f8d-b654-aa1f8116ab41

Response Fields

string

The unique ID of the alert

account

object

Account linked to the alert

additional_recipients

string[]

When type is 'called', you can provide additional sms recipients

all_tracked_numbers

boolean

Defines if all numbers need to be impacted

created_at

datetime

Creation datetime. Format: YYYY-MM-DD HH:mm:ss

enabled

boolean

Defines if the alert is actived or not

landing_page

string

ID of the Landing from the Studio

less_than

integer

Used with the type 'custom_calls', it defines the time before not sending the alert. Can't be set with 'more_than'

more_than

integer

Used with the type 'custom_calls', it defines the time before sending the alert. Can't be set with 'less_than'

notification_emails

string[]

Array of email who will receive an email alert when a new lead is created from the landing page. Used with landing_page

notification_recipients

string[]

Array of recipient who will receive an sms alert when a new lead is created from the landing page. Used with landing_page

numbers

string[]

Array of number ID linked to the alert. Cannot be used with 'all_tracked_numbers'

pools

string[]

Array of pool ID linked to the alert. Cannot be used with 'all_tracked_numbers'

send_to

string

Defines who receive the SMS. Enum: called, caller

sms_template

object

SMS template from the Studio

title

string

Alert title

type

string

Defines which type of call the SMS is sent on. Enum: lost_calls, custom_calls, all_calls

Example request:

curl --request GET \
    --get "https://api.magnetis.io/alerts/sms/als-06529b90-73e1-4f8d-b654-aa1f8116ab41" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": {
        "id": "als-f3f2849a-e306-4a00-b539-45bc48b95b61",
        "account": {
            "id": "acc-f27c03a5-9498-4dd1-aeeb-30722b219f2e",
            "name": "Immobilier tertiaire"
        },
        "additional_recipients": [],
        "all_tracked_numbers": 1,
        "created_at": "2024-03-07 10:34:09",
        "enabled": 1,
        "landing_page": {
            "id": "8810c59a-c05c-4801-a3e7-c77308296c9c",
            "account": {
                "id": "acc-f27c03a5-9498-4dd1-aeeb-30722b219f2e",
                "name": "Immobilier tertiaire"
            },
            "created_at": "2024-01-01 01:00:00",
            "entity": null,
            "network": null,
            "title": "Ma Landing Page",
            "url": "https://www.mywebsite.fr"
        },
        "less_than": null,
        "more_than": null,
        "notification_emails": [],
        "notification_recipients": [],
        "numbers": [],
        "pools": [],
        "send_to": "caller",
        "sms_template": {
            "id": "sds-3712da26-d91e-4d9a-8545-2a6a4023231b32",
            "account": {
                "id": "acc-f27c03a5-9498-4dd1-aeeb-30722b219f2e",
                "name": "Immobilier tertiaire"
            },
            "created_at": "2024-03-01 14:52:46",
            "entity": null,
            "from": "InfoAppel",
            "network": null,
            "nb_characters": 2121,
            "nb_sms": 2,
            "text": "Nous avons raté votre appel, completer le question ##LIENTRACKEVERSLANDPAGE## pour que nous puissions vous recontacter. A bientôt.",
            "title": "Appel Manqué Appelé",
            "user": {
                "id": "usr-78a51d97-1bd2-467e-b67c-bb683014e84c",
                "created_at": "2024-03-01 14:52:43",
                "email": "John.Doe@email.fr",
                "firstname": "John",
                "lang": "fr",
                "lastname": "Doe",
                "phone": "06 38 39 XX XX"
            }
        },
        "title": "Sms de landing page",
        "type": "lost_calls"
    },
    "meta": {
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2024-03-04 09:12:08",
            "expiration": null,
            "level": "account",
            "name": "My account"
        },
        "total": 1
    }
}

Update a SMS alert

PUT

PATCH

https://api.magnetis.io

/alerts/sms/{id}

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

string

required

Alert ID.

Example:

als-06529b90-73e1-4f8d-b654-aa1f8116ab41

Body Parameters

additional_recipients

Additional Recipient IDs to the alert when 'send_to' equals to called

all_tracked_numbers

boolean

Defines if it's active on all numbers and pools and on selected numbers and/or pools

enabled

boolean

required

Defines if the alert is actived or not

landing_page_id

string

Used if your sms template have the landing page variable inside content.
The variable will be replace with a shortlink of the landing page url

Example:

ldp-53470c4d-7721-4490-bd22-237066afd5c5

less_than

integer

Used when type is custom_calls and more_than is not set.
Represent how many second the call must not exceed in duration before thinking of send the alert

Example:

more_than

integer

Used when type is custom_calls and less_than is not set.
Represent how many second the call must have in duration before thinking of send the alert

Example:

notification_emails

string[]

Array of email who will receive an email alert when a new lead is created from the landing page. Used with landing_page.

Example:

["amazingemail@email.com","thebestemail@email.com"]

notification_recipients

string[]

Array of recipient who will receive an sms alert when a new lead is created from the landing page. Used with landing_page.

Example:

["rcp-8b514c55-f135-48da-83e4-1a1cd3cccb84","rcp-75e932ca-6714-4088-b571-e6047a0dd1c6"]

numbers

string[]

List of number_id on which activated the alert

Example:

["num-50700e9e-879e-480a-859a-1db8301bd712","num-87b2e273-29c7-41a9-bd7e-66748d9cdf40"]

pools

string[]

List of pool_id on which activated the alert

Example:

["pul-50700e9e-879e-480a-859a-1db8301bd712","pul-87b2e273-29c7-41a9-bd7e-66748d9cdf40"]

send_to

string

Sms sent to Caller or Called number if mobile
Enum: caller or called

Example:

caller

sms_template_id

string

required

SMS template fron the studio

Example:

sds-8dc0d51c-bd63-4aaf-ab64-6fb46edb17ac

title

string

required

Alert Title

Example:

Alerte avec Landing Page

type

string

required

Type of the alert.
Can be: lost_calls, custom_calls or all_calls

Example:

custom_calls

Response Fields

string

The unique ID of the alert

account

object

Account linked to the alert

additional_recipients

string[]

When type is 'called', you can provide additional sms recipients

all_tracked_numbers

boolean

Defines if all numbers need to be impacted

created_at

datetime

Creation datetime. Format: YYYY-MM-DD HH:mm:ss

enabled

boolean

Defines if the alert is actived or not

landing_page

string

ID of the Landing from the Studio

less_than

integer

Used with the type 'custom_calls', it defines the time before not sending the alert. Can't be set with 'more_than'

more_than

integer

Used with the type 'custom_calls', it defines the time before sending the alert. Can't be set with 'less_than'

notification_emails

string[]

Array of email who will receive an email alert when a new lead is created from the landing page. Used with landing_page

notification_recipients

string[]

Array of recipient who will receive an sms alert when a new lead is created from the landing page. Used with landing_page

numbers

string[]

Array of number ID linked to the alert. Cannot be used with 'all_tracked_numbers'

pools

string[]

Array of pool ID linked to the alert. Cannot be used with 'all_tracked_numbers'

send_to

string

Defines who receive the SMS. Enum: called, caller

sms_template

object

SMS template from the Studio

title

string

Alert title

type

string

Defines which type of call the SMS is sent on. Enum: lost_calls, custom_calls, all_calls

Example request:

curl --request PUT \
    "https://api.magnetis.io/alerts/sms/als-06529b90-73e1-4f8d-b654-aa1f8116ab41" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"additional_recipients\": false,
    \"all_tracked_numbers\": false,
    \"enabled\": null,
    \"landing_page_id\": \"ldp-53470c4d-7721-4490-bd22-237066afd5c5\",
    \"less_than\": 15,
    \"more_than\": 19,
    \"notification_emails\": [
        \"amazingemail@email.com\",
        \"thebestemail@email.com\"
    ],
    \"notification_recipients\": [
        \"rcp-8b514c55-f135-48da-83e4-1a1cd3cccb84\",
        \"rcp-75e932ca-6714-4088-b571-e6047a0dd1c6\"
    ],
    \"numbers\": [
        \"num-50700e9e-879e-480a-859a-1db8301bd712\",
        \"num-87b2e273-29c7-41a9-bd7e-66748d9cdf40\"
    ],
    \"pools\": [
        \"pul-50700e9e-879e-480a-859a-1db8301bd712\",
        \"pul-87b2e273-29c7-41a9-bd7e-66748d9cdf40\"
    ],
    \"send_to\": \"caller\",
    \"sms_template_id\": \"sds-8dc0d51c-bd63-4aaf-ab64-6fb46edb17ac\",
    \"title\": \"Alerte avec Landing Page\",
    \"type\": \"custom_calls\"
}"

Example response:

{
    "data": {
        "id": "als-f3f2849a-e306-4a00-b539-45bc48b95b61",
        "account": {
            "id": "acc-f27c03a5-9498-4dd1-aeeb-30722b219f2e",
            "name": "Immobilier tertiaire"
        },
        "additional_recipients": [],
        "all_tracked_numbers": 1,
        "created_at": "2024-03-07 10:34:09",
        "enabled": 1,
        "landing_page": {
            "id": "8810c59a-c05c-4801-a3e7-c77308296c9c",
            "account": {
                "id": "acc-f27c03a5-9498-4dd1-aeeb-30722b219f2e",
                "name": "Immobilier tertiaire"
            },
            "created_at": "2024-01-01 01:00:00",
            "entity": null,
            "network": null,
            "title": "Ma Landing Page",
            "url": "https://www.mywebsite.fr"
        },
        "less_than": null,
        "more_than": null,
        "notification_emails": [],
        "notification_recipients": [],
        "numbers": [],
        "pools": [],
        "send_to": "caller",
        "sms_template": {
            "id": "sds-3712da26-d91e-4d9a-8545-2a6a4023231b32",
            "account": {
                "id": "acc-f27c03a5-9498-4dd1-aeeb-30722b219f2e",
                "name": "Immobilier tertiaire"
            },
            "created_at": "2024-03-01 14:52:46",
            "entity": null,
            "from": "InfoAppel",
            "network": null,
            "nb_characters": 2121,
            "nb_sms": 2,
            "text": "Nous avons raté votre appel, completer le question ##LIENTRACKEVERSLANDPAGE## pour que nous puissions vous recontacter. A bientôt.",
            "title": "Appel Manqué Appelé",
            "user": {
                "id": "usr-78a51d97-1bd2-467e-b67c-bb683014e84c",
                "created_at": "2024-03-01 14:52:43",
                "email": "John.Doe@email.fr",
                "firstname": "John",
                "lang": "fr",
                "lastname": "Doe",
                "phone": "06 38 39 XX XX"
            }
        },
        "title": "Sms de landing page",
        "type": "lost_calls"
    },
    "meta": {
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2024-03-04 09:12:08",
            "expiration": null,
            "level": "account",
            "name": "My account"
        },
        "total": 1
    }
}

Delete a sms alert

DELETE

https://api.magnetis.io

/alerts/sms/{id}

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

string

required

The id of the alert.

Example:

als-06529b90-73e1-4f8d-b654-aa1f8116ab41

Response Fields

string

The unique ID of the alert

account

object

Account linked to the alert

additional_recipients

string[]

When type is 'called', you can provide additional sms recipients

all_tracked_numbers

boolean

Defines if all numbers need to be impacted

created_at

datetime

Creation datetime. Format: YYYY-MM-DD HH:mm:ss

enabled

boolean

Defines if the alert is actived or not

landing_page

string

ID of the Landing from the Studio

less_than

integer

Used with the type 'custom_calls', it defines the time before not sending the alert. Can't be set with 'more_than'

more_than

integer

Used with the type 'custom_calls', it defines the time before sending the alert. Can't be set with 'less_than'

notification_emails

string[]

Array of email who will receive an email alert when a new lead is created from the landing page. Used with landing_page

notification_recipients

string[]

Array of recipient who will receive an sms alert when a new lead is created from the landing page. Used with landing_page

numbers

string[]

Array of number ID linked to the alert. Cannot be used with 'all_tracked_numbers'

pools

string[]

Array of pool ID linked to the alert. Cannot be used with 'all_tracked_numbers'

send_to

string

Defines who receive the SMS. Enum: called, caller

sms_template

object

SMS template from the Studio

title

string

Alert title

type

string

Defines which type of call the SMS is sent on. Enum: lost_calls, custom_calls, all_calls

Example request:

curl --request DELETE \
    "https://api.magnetis.io/alerts/sms/als-06529b90-73e1-4f8d-b654-aa1f8116ab41" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [],
    "meta": {
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "account",
            "name": "My account"
        },
        "total": 0
    }
}

Architecture

Organizations

Fetch an organization

GET

https://api.magnetis.io

/organization

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

Response Fields

string

The unique ID of the organization

activity

string

Entity activity. Enum: Accessoires moto et voitures,Agriculture,Animal,Annuaire,Architecture et plan,Art & culture,Assainissement,Association,Assurance,Audition,Automobile,Autre,Auxiliaire de vie sociale,Banque,Biens de luxe et bijoux,Boulangerie & pâtisserie,Camping,Chauffage,Chauffagiste,Climatisation,Coaching,Coaching & développement personnel,Coiffure,Commerce de détail,Commerce de gros,Commerçant,Compagnies aériennes,Comptabilité,Conciergerie,Conseil,Construction,Cuisiniste,Culture jouet multimedia,Distribution et logistique,Divers,Décoration et ameublement,Déménagement,EHPAD,Ebeniste,Ecommerce,Electricité,Employé de ménage à domicile,Energie,Enseignement supérieur,Evenements & spectacles,Fenêtres,Fitness,Fleuriste,Formation en ligne,Formation profesionnelle,Fournitures et équipement professionnels,Funéraire,Garde d'enfants,Garde d'enfants à domicile,Hôpitaux et soins de santé,Hôtellerie,Immobilier commercial,Immobilier promotion,Immobilier tertiaire,Impression,Industrie & commerce et services nautiques,Informatique et technologies de l'information,Isolation,Journal,Juridique,Location d'espaces de stockage,Location d'équipement et d'outils,Location de matériel de loisir,Location véhicule,Logiciel,Loisirs créatifs,Loisirs nautiques,Machinerie,Magasin de bricolage,Mariage,Moto,Musique,Mutuelle,Médecine,Média de diffusion,Média en ligne,Nuisibles,Nutrition et diététique,Onglerie,Optique,Organisation de voyage,Parcs d'attraction,Pare-brise,Peintre en bâtiment,Pergolas & vérandas,Pharmacie,Photographie,Piscines,Plombier,Ports de plaisance,Pressing,Produits de beauté et soins personnels,Professionnels de la communication,Relations publiques,Ressources humaines,Restauration,Restauration rapide,Rénovation energétique,Salle de sport,Soin du corps,Spas,Supermarché,Toiture,Traiteur,Transport,Télécomunications,Vins et spiritueux

billing_details

object

Organization billing details

address

string

Billing address

city

string

Billing city

country

string

Billing country

billing_email

string

Billing email

phone

string

Billing phone number

siret

string

SIRET number

tva_number

string

VAT number

zipcode

string

Billing zip code

company

string

Company name

created_at

datetime

Creation datetime of the account. Format: YYYY-MM-DD HH:mm:ss

external_id

string

Billing custom reference

rgpd

string

RGPD settings of the organization. Enum: 1 (All calling numbers are truncated), 2 (Only calling numbers from missed calls are fully displayed), 3 (All calling number are fully displayed)

Example request:

curl --request GET \
    --get "https://api.magnetis.io/organization" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "id": "org-206cfd6e-c95e-4aee-9068-164c8539f85a",
    "activity": "Immobilier tertiaire",
    "billing_details": {
        "address": "1 rue de la Mairie",
        "city": "Paris",
        "country": "FRA",
        "billing_email": "comptabilite@mycompany.fr",
        "phone": "0033611223344",
        "siret": "987654321",
        "tva_number": "FR123456789",
        "zipcode": "75001"
    },
    "company": "My company",
    "created_at": "2023-07-25 12:00:00",
    "external_id": "Project ABC",
    "rgpd": 2
}

Update an organization

PUT

PATCH

https://api.magnetis.io

/organization

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

Body Parameters

activity

string

required

The organization activity. Enum: Accessoires moto et voitures,Agriculture,Animal,Annuaire,Architecture et plan,Art & culture,Assainissement,Association,Assurance,Audition,Automobile,Autre,Auxiliaire de vie sociale,Banque,Biens de luxe et bijoux,Boulangerie & pâtisserie,Camping,Chauffage,Chauffagiste,Climatisation,Coaching,Coaching & développement personnel,Coiffure,Commerce de détail,Commerce de gros,Commerçant,Compagnies aériennes,Comptabilité,Conciergerie,Conseil,Construction,Cuisiniste,Culture jouet multimedia,Distribution et logistique,Divers,Décoration et ameublement,Déménagement,EHPAD,Ebeniste,Ecommerce,Electricité,Employé de ménage à domicile,Energie,Enseignement supérieur,Evenements & spectacles,Fenêtres,Fitness,Fleuriste,Formation en ligne,Formation profesionnelle,Fournitures et équipement professionnels,Funéraire,Garde d'enfants,Garde d'enfants à domicile,Hôpitaux et soins de santé,Hôtellerie,Immobilier commercial,Immobilier promotion,Immobilier tertiaire,Impression,Industrie & commerce et services nautiques,Informatique et technologies de l'information,Isolation,Journal,Juridique,Location d'espaces de stockage,Location d'équipement et d'outils,Location de matériel de loisir,Location véhicule,Logiciel,Loisirs créatifs,Loisirs nautiques,Machinerie,Magasin de bricolage,Mariage,Moto,Musique,Mutuelle,Médecine,Média de diffusion,Média en ligne,Nuisibles,Nutrition et diététique,Onglerie,Optique,Organisation de voyage,Parcs d'attraction,Pare-brise,Peintre en bâtiment,Pergolas & vérandas,Pharmacie,Photographie,Piscines,Plombier,Ports de plaisance,Pressing,Produits de beauté et soins personnels,Professionnels de la communication,Relations publiques,Ressources humaines,Restauration,Restauration rapide,Rénovation energétique,Salle de sport,Soin du corps,Spas,Supermarché,Toiture,Traiteur,Transport,Télécomunications,Vins et spiritueux

Example:

Automobile

external_id

string

Project reference / quotation

Example:

DV-12321

rgpd

integer

Define the degree of compliance you want on numbers display.
Between 1 and 3

Example:

company

string

Company name

Example:

Example&Co

billing_details

object

address

string

Billing address

Example:

691 Impasse Mallet

city

string

Billing city

Example:

Millet-sur-Pires

country

string

Billing country

Example:

FRA

billing_email

string

Billing email

Example:

billing@company.com

phone

string

Billing phone

Example:

003393455XXXX

siret

string

SIRET number

Example:

123 456 789 00012

zipcode

string

Billing zipcode

Example:

33160

tva_number

string

VAT number

Example:

FR123456789

Response Fields

string

The unique ID of the organization

activity

string

billing_details

object

Organization billing details

address

string

Billing address

city

string

Billing city

country

string

Billing country

billing_email

string

Billing email

phone

string

Billing phone number

siret

string

SIRET number

tva_number

string

VAT number

zipcode

string

Billing zip code

company

string

Company name

created_at

datetime

Creation datetime of the account. Format: YYYY-MM-DD HH:mm:ss

external_id

string

Billing custom reference

rgpd

string

RGPD settings of the organization. Enum: 1 (All calling numbers are truncated), 2 (Only calling numbers from missed calls are fully displayed), 3 (All calling number are fully displayed)

Example request:

curl --request PUT \
    "https://api.magnetis.io/organization" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"activity\": \"Automobile\",
    \"external_id\": \"DV-12321\",
    \"rgpd\": 3,
    \"company\": \"Example&Co\",
    \"billing_details\": {
        \"address\": \"691 Impasse Mallet\",
        \"city\": \"Millet-sur-Pires\",
        \"country\": \"FRA\",
        \"billing_email\": \"billing@company.com\",
        \"phone\": \"003393455XXXX\",
        \"siret\": \"123 456 789 00012\",
        \"zipcode\": \"33160\",
        \"tva_number\": \"FR123456789\"
    }
}"

Example response:

{
    "id": "org-206cfd6e-c95e-4aee-9068-164c8539f85a",
    "activity": "Immobilier tertiaire",
    "billing_details": {
        "address": "1 rue de la Mairie",
        "city": "Paris",
        "country": "FRA",
        "billing_email": "comptabilite@mycompany.fr",
        "phone": "0033611223344",
        "siret": "987654321",
        "tva_number": "FR123456789",
        "zipcode": "75001"
    },
    "company": "My company",
    "created_at": "2023-07-25 12:00:00",
    "external_id": "Project ABC",
    "rgpd": 2
}

Get organization architecture

GET

https://api.magnetis.io

/organization/architecture

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

Response Fields

string

The unique ID of the organization

activity

string

billing_details

object

Organization billing details

address

string

Billing address

city

string

Billing city

country

string

Billing country

billing_email

string

Billing email

phone

string

Billing phone number

siret

string

SIRET number

tva_number

string

VAT number

zipcode

string

Billing zip code

company

string

Company name

created_at

datetime

Creation datetime of the account. Format: YYYY-MM-DD HH:mm:ss

external_id

string

Billing custom reference

rgpd

string

RGPD settings of the organization. Enum: 1 (All calling numbers are truncated), 2 (Only calling numbers from missed calls are fully displayed), 3 (All calling number are fully displayed)

Example request:

curl --request GET \
    --get "https://api.magnetis.io/organization/architecture" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

Headers

                                                            cache-control
                                                            : no-cache, private
                                                                                                                    content-type
                                                            : application/json
                                                                                                                    x-ratelimit-limit
                                                            : 600
                                                                                                                    x-ratelimit-remaining
                                                            : 599

{
    "error": "Api key is invalid",
    "data": []
}

Networks

List all networks

GET

https://api.magnetis.io

/networks

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

limit

Optional. Result per page. 250 if not set.

Example:

250

page

Optional. Pagination page. 1 if not set.

Example:

Response Fields

string

ID of the network

activity

string

Network activity. Enum: Accessoires moto et voitures,Agriculture,Animal,Annuaire,Architecture et plan,Art & culture,Assainissement,Association,Assurance,Audition,Automobile,Autre,Auxiliaire de vie sociale,Banque,Biens de luxe et bijoux,Boulangerie & pâtisserie,Camping,Chauffage,Chauffagiste,Climatisation,Coaching,Coaching & développement personnel,Coiffure,Commerce de détail,Commerce de gros,Commerçant,Compagnies aériennes,Comptabilité,Conciergerie,Conseil,Construction,Cuisiniste,Culture jouet multimedia,Distribution et logistique,Divers,Décoration et ameublement,Déménagement,EHPAD,Ebeniste,Ecommerce,Electricité,Employé de ménage à domicile,Energie,Enseignement supérieur,Evenements & spectacles,Fenêtres,Fitness,Fleuriste,Formation en ligne,Formation profesionnelle,Fournitures et équipement professionnels,Funéraire,Garde d'enfants,Garde d'enfants à domicile,Hôpitaux et soins de santé,Hôtellerie,Immobilier commercial,Immobilier promotion,Immobilier tertiaire,Impression,Industrie & commerce et services nautiques,Informatique et technologies de l'information,Isolation,Journal,Juridique,Location d'espaces de stockage,Location d'équipement et d'outils,Location de matériel de loisir,Location véhicule,Logiciel,Loisirs créatifs,Loisirs nautiques,Machinerie,Magasin de bricolage,Mariage,Moto,Musique,Mutuelle,Médecine,Média de diffusion,Média en ligne,Nuisibles,Nutrition et diététique,Onglerie,Optique,Organisation de voyage,Parcs d'attraction,Pare-brise,Peintre en bâtiment,Pergolas & vérandas,Pharmacie,Photographie,Piscines,Plombier,Ports de plaisance,Pressing,Produits de beauté et soins personnels,Professionnels de la communication,Relations publiques,Ressources humaines,Restauration,Restauration rapide,Rénovation energétique,Salle de sport,Soin du corps,Spas,Supermarché,Toiture,Traiteur,Transport,Télécomunications,Vins et spiritueux

created_at

datetime

Creation date of the network

name

string

Network name

parent_network_id

?string

ID of the parent network if this network is a child

rgpd

integer

RGPD setting set for this network

Example request:

curl --request GET \
    --get "https://api.magnetis.io/networks" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [
        {
            "id": "net-bd05fbcd-4623-4ba5-b1fd-d586198334f7",
            "activity": "Immobilier tertiaire",
            "created_at": "2323-06-27 10:40:00",
            "name": "Réseau Ile de France",
            "parent_network_id": null,
            "rgpd": 3
        },
        {
            "id": "net-47cd1df6-d252-46af-8c18-32da13aa3d33",
            "activity": "Automobile",
            "created_at": "2323-06-27 10:40:00",
            "name": "Réseau Nord Ouest",
            "parent_network_id": null,
            "rgpd": 3
        },
        {
            "id": "net-204958f3-0665-4205-b08d-b3c300c4e9a2",
            "activity": "Construction",
            "created_at": "2323-06-27 10:40:00",
            "name": "Réseau Sud Est",
            "parent_network_id": null,
            "rgpd": 3
        }
    ],
    "links": {
        "first": "https://api.magnetis.io/networks?page=1",
        "last": "https://api.magnetis.io/networks?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "path": "https://api.magnetis.io/networks",
        "per_page": 250,
        "to": 3,
        "total": 3,
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "account",
            "name": "My account"
        }
    }
}

Create a network

POST

https://api.magnetis.io

/networks

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

Body Parameters

activity

string

required

The account activity. Enum: Accessoires moto et voitures,Agriculture,Animal,Annuaire,Architecture et plan,Art & culture,Assainissement,Association,Assurance,Audition,Automobile,Autre,Auxiliaire de vie sociale,Banque,Biens de luxe et bijoux,Boulangerie & pâtisserie,Camping,Chauffage,Chauffagiste,Climatisation,Coaching,Coaching & développement personnel,Coiffure,Commerce de détail,Commerce de gros,Commerçant,Compagnies aériennes,Comptabilité,Conciergerie,Conseil,Construction,Cuisiniste,Culture jouet multimedia,Distribution et logistique,Divers,Décoration et ameublement,Déménagement,EHPAD,Ebeniste,Ecommerce,Electricité,Employé de ménage à domicile,Energie,Enseignement supérieur,Evenements & spectacles,Fenêtres,Fitness,Fleuriste,Formation en ligne,Formation profesionnelle,Fournitures et équipement professionnels,Funéraire,Garde d'enfants,Garde d'enfants à domicile,Hôpitaux et soins de santé,Hôtellerie,Immobilier commercial,Immobilier promotion,Immobilier tertiaire,Impression,Industrie & commerce et services nautiques,Informatique et technologies de l'information,Isolation,Journal,Juridique,Location d'espaces de stockage,Location d'équipement et d'outils,Location de matériel de loisir,Location véhicule,Logiciel,Loisirs créatifs,Loisirs nautiques,Machinerie,Magasin de bricolage,Mariage,Moto,Musique,Mutuelle,Médecine,Média de diffusion,Média en ligne,Nuisibles,Nutrition et diététique,Onglerie,Optique,Organisation de voyage,Parcs d'attraction,Pare-brise,Peintre en bâtiment,Pergolas & vérandas,Pharmacie,Photographie,Piscines,Plombier,Ports de plaisance,Pressing,Produits de beauté et soins personnels,Professionnels de la communication,Relations publiques,Ressources humaines,Restauration,Restauration rapide,Rénovation energétique,Salle de sport,Soin du corps,Spas,Supermarché,Toiture,Traiteur,Transport,Télécomunications,Vins et spiritueux

Example:

Automobile

parent_network_id

string

The parent network id you want to link this new network

Example:

net-XXX

name

string

required

The name of this new network

Example:

Point de vente N°1

Response Fields

string

ID of the network

activity

string

created_at

datetime

Creation date of the network

name

string

Network name

parent_network_id

?string

ID of the parent network if this network is a child

rgpd

integer

RGPD setting set for this network

Example request:

curl --request POST \
    "https://api.magnetis.io/networks" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"activity\": \"Automobile\",
    \"parent_network_id\": \"net-XXX\",
    \"name\": \"Point de vente N°1\"
}"

Example response:

{
    "data": {
        "id": "net-bd05fbcd-4623-4ba5-b1fd-d586198334f7",
        "activity": "Immobilier tertiaire",
        "created_at": "2323-06-27 10:40:00",
        "name": "Réseau Ile de France",
        "parent_network_id": null,
        "rgpd": 3
    },
    "meta": {
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "network",
            "name": "My network"
        },
        "total": 1
    }
}

Fetch a network

GET

https://api.magnetis.io

/networks/{id}

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

slug

string

required

The id of the network.

Example:

net-f3c61104-d94f-4a5f-8fcb-7a63fcc89a6c

Response Fields

string

ID of the network

activity

string

created_at

datetime

Creation date of the network

name

string

Network name

parent_network_id

?string

ID of the parent network if this network is a child

rgpd

integer

RGPD setting set for this network

Example request:

curl --request GET \
    --get "https://api.magnetis.io/networks/1" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": {
        "id": "net-bd05fbcd-4623-4ba5-b1fd-d586198334f7",
        "activity": "Immobilier tertiaire",
        "created_at": "2323-06-27 10:40:00",
        "name": "Réseau Ile de France",
        "parent_network_id": null,
        "rgpd": 3
    },
    "meta": {
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "network",
            "name": "My network"
        },
        "total": 1
    }
}

Update a network

PUT

PATCH

https://api.magnetis.io

/networks/{id}

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

slug

string

required

The id of the network.

Example:

net-f3c61104-d94f-4a5f-8fcb-7a63fcc89a6c

Body Parameters

activity

string

required

Example:

Automobile

name

string

required

The name of this new network

Example:

Point de vente N°1

Response Fields

string

ID of the network

activity

string

created_at

datetime

Creation date of the network

name

string

Network name

parent_network_id

?string

ID of the parent network if this network is a child

rgpd

integer

RGPD setting set for this network

Example request:

curl --request PUT \
    "https://api.magnetis.io/networks/1" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"activity\": \"Automobile\",
    \"name\": \"Point de vente N°1\"
}"

Example response:

{
    "data": {
        "id": "net-bd05fbcd-4623-4ba5-b1fd-d586198334f7",
        "activity": "Immobilier tertiaire",
        "created_at": "2323-06-27 10:40:00",
        "name": "Réseau Ile de France",
        "parent_network_id": null,
        "rgpd": 3
    },
    "meta": {
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "network",
            "name": "My network"
        },
        "total": 1
    }
}

Remove a network

DELETE

https://api.magnetis.io

/networks/{id}

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

slug

string

required

The id of the network.

Example:

net-f3c61104-d94f-4a5f-8fcb-7a63fcc89a6c

Response Fields

string

ID of the network

activity

string

created_at

datetime

Creation date of the network

name

string

Network name

parent_network_id

?string

ID of the parent network if this network is a child

rgpd

integer

RGPD setting set for this network

Example request:

curl --request DELETE \
    "https://api.magnetis.io/networks/1" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": {
        "id": "net-bd05fbcd-4623-4ba5-b1fd-d586198334f7",
        "activity": "Immobilier tertiaire",
        "created_at": "2323-06-27 10:40:00",
        "name": "Réseau Ile de France",
        "parent_network_id": null,
        "rgpd": 3
    },
    "meta": {
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "network",
            "name": "My network"
        },
        "total": 1
    }
}

List all networks children of a network

GET

https://api.magnetis.io

/networks/{network}/networks

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

slug

string

required

The id of the network.

Example:

net-f3c61104-d94f-4a5f-8fcb-7a63fcc89a6c

Response Fields

string

ID of the network

activity

string

created_at

datetime

Creation date of the network

name

string

Network name

parent_network_id

?string

ID of the parent network if this network is a child

rgpd

integer

RGPD setting set for this network

Example request:

curl --request GET \
    --get "https://api.magnetis.io/networks/1/networks" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [
        {
            "id": "net-bd05fbcd-4623-4ba5-b1fd-d586198334f7",
            "activity": "Immobilier tertiaire",
            "created_at": "2323-06-27 10:40:00",
            "name": "Réseau Ile de France",
            "parent_network_id": null,
            "rgpd": 3
        },
        {
            "id": "net-47cd1df6-d252-46af-8c18-32da13aa3d33",
            "activity": "Automobile",
            "created_at": "2323-06-27 10:40:00",
            "name": "Réseau Nord Ouest",
            "parent_network_id": null,
            "rgpd": 3
        },
        {
            "id": "net-204958f3-0665-4205-b08d-b3c300c4e9a2",
            "activity": "Construction",
            "created_at": "2323-06-27 10:40:00",
            "name": "Réseau Sud Est",
            "parent_network_id": null,
            "rgpd": 3
        }
    ],
    "links": {
        "first": "https://api.magnetis.io/networks?page=1",
        "last": "https://api.magnetis.io/networks?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "path": "https://api.magnetis.io/networks",
        "per_page": 250,
        "to": 3,
        "total": 3,
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "account",
            "name": "My account"
        }
    }
}

Accounts

List all accounts

GET

https://api.magnetis.io

/accounts

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

limit

Optional. Result per page. 250 if not set.

Example:

250

page

Optional. Pagination page. 1 if not set.

Example:

Response Fields

string

The unique ID of the account

activity

string

Account activity. Enum: Accessoires moto et voitures,Agriculture,Animal,Annuaire,Architecture et plan,Art & culture,Assainissement,Association,Assurance,Audition,Automobile,Autre,Auxiliaire de vie sociale,Banque,Biens de luxe et bijoux,Boulangerie & pâtisserie,Camping,Chauffage,Chauffagiste,Climatisation,Coaching,Coaching & développement personnel,Coiffure,Commerce de détail,Commerce de gros,Commerçant,Compagnies aériennes,Comptabilité,Conciergerie,Conseil,Construction,Cuisiniste,Culture jouet multimedia,Distribution et logistique,Divers,Décoration et ameublement,Déménagement,EHPAD,Ebeniste,Ecommerce,Electricité,Employé de ménage à domicile,Energie,Enseignement supérieur,Evenements & spectacles,Fenêtres,Fitness,Fleuriste,Formation en ligne,Formation profesionnelle,Fournitures et équipement professionnels,Funéraire,Garde d'enfants,Garde d'enfants à domicile,Hôpitaux et soins de santé,Hôtellerie,Immobilier commercial,Immobilier promotion,Immobilier tertiaire,Impression,Industrie & commerce et services nautiques,Informatique et technologies de l'information,Isolation,Journal,Juridique,Location d'espaces de stockage,Location d'équipement et d'outils,Location de matériel de loisir,Location véhicule,Logiciel,Loisirs créatifs,Loisirs nautiques,Machinerie,Magasin de bricolage,Mariage,Moto,Musique,Mutuelle,Médecine,Média de diffusion,Média en ligne,Nuisibles,Nutrition et diététique,Onglerie,Optique,Organisation de voyage,Parcs d'attraction,Pare-brise,Peintre en bâtiment,Pergolas & vérandas,Pharmacie,Photographie,Piscines,Plombier,Ports de plaisance,Pressing,Produits de beauté et soins personnels,Professionnels de la communication,Relations publiques,Ressources humaines,Restauration,Restauration rapide,Rénovation energétique,Salle de sport,Soin du corps,Spas,Supermarché,Toiture,Traiteur,Transport,Télécomunications,Vins et spiritueux

address

object

Account address informations

created_at

datetime

Creation datetime of the account. Format: YYYY-MM-DD HH:mm:ss

name

string

Account name

parent_network_id

string|null

The unique ID of the network in which the account is

rgpd

string

RGPD settings of the account. Enum: 1 (All calling numbers are truncated), 2 (Only calling numbers from missed calls are fully displayed), 3 (All calling number are fully displayed)

Example request:

curl --request GET \
    --get "https://api.magnetis.io/accounts" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [
        {
            "id": "acc-f27c03a5-9498-4dd1-aeeb-30722b219f2e",
            "activity": "Immobilier tertiaire",
            "address": {
                "zipcode": "75015",
                "city": "Paris",
                "country": "FRA"
            },
            "created_at": "2023-07-20 13:58:30",
            "name": "Immo Paris",
            "parent_network_id": "net-bd05fbcd-4623-4ba5-b1fd-d586198334f7",
            "rgpd": 1
        },
        {
            "id": "acc-f702dcb6-87cf-4bc4-8632-560c43aec1a4",
            "activity": "Automobile",
            "address": {
                "zipcode": "33000",
                "city": "Bordeaux",
                "country": "FRA"
            },
            "created_at": "2023-07-14 11:52:27",
            "name": "Auto Bordeaux",
            "parent_network_id": null,
            "rgpd": 2
        },
        {
            "id": "acc-250ce1bd-237d-4e2d-aa17-51293760a801",
            "activity": "Construction",
            "address": {
                "zipcode": "69000",
                "city": "Lyon",
                "country": "FRA"
            },
            "created_at": "2023-06-25 07:34:12",
            "name": "Artisan Lyon",
            "parent_network_id": null,
            "rgpd": 3
        }
    ],
    "links": {
        "first": "https://api.magnetis.io/accounts?page=1",
        "last": "https://api.magnetis.io/accounts?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "path": "https://api.magnetis.io/accounts",
        "per_page": 250,
        "to": 3,
        "total": 3,
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "account",
            "name": "My account"
        }
    }
}

Create an account

POST

https://api.magnetis.io

/accounts

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

Body Parameters

activity

string

required

Example:

Automobile

city

string

required

The account city

Example:

Paris

country

string

required

The account country

Example:

FRA

name

string

required

The account name

Example:

My account

parent_network_id

string

The account parent network id

Example:

net-XXX

zipcode

string

required

The account zipcode

Example:

75000

Response Fields

string

The unique ID of the account

activity

string

address

object

Account address informations

created_at

datetime

Creation datetime of the account. Format: YYYY-MM-DD HH:mm:ss

name

string

Account name

parent_network_id

string|null

The unique ID of the network in which the account is

rgpd

string

RGPD settings of the account. Enum: 1 (All calling numbers are truncated), 2 (Only calling numbers from missed calls are fully displayed), 3 (All calling number are fully displayed)

Example request:

curl --request POST \
    "https://api.magnetis.io/accounts" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"activity\": \"Automobile\",
    \"city\": \"Paris\",
    \"country\": \"FRA\",
    \"name\": \"My account\",
    \"parent_network_id\": \"net-XXX\",
    \"zipcode\": \"75000\"
}"

Example response:

{
    "data": {
        "id": "acc-f27c03a5-9498-4dd1-aeeb-30722b219f2e",
        "activity": "Immobilier tertiaire",
        "address": {
            "zipcode": "75015",
            "city": "Paris",
            "country": "FRA"
        },
        "created_at": "2023-07-20 13:58:30",
        "name": "Immo Paris",
        "parent_network_id": null,
        "rgpd": 1
    },
    "meta": {
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "account",
            "name": "My account"
        },
        "total": 1
    }
}

Fetch an account

GET

https://api.magnetis.io

/accounts/{id}

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

slug

string

required

The ID of the account.

Example:

acc-6e64b651-026a-46de-ab3e-944a193945a9

Response Fields

string

The unique ID of the account

activity

string

address

object

Account address informations

created_at

datetime

Creation datetime of the account. Format: YYYY-MM-DD HH:mm:ss

name

string

Account name

parent_network_id

string|null

The unique ID of the network in which the account is

rgpd

string

RGPD settings of the account. Enum: 1 (All calling numbers are truncated), 2 (Only calling numbers from missed calls are fully displayed), 3 (All calling number are fully displayed)

Example request:

curl --request GET \
    --get "https://api.magnetis.io/accounts/1" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": {
        "id": "acc-f27c03a5-9498-4dd1-aeeb-30722b219f2e",
        "activity": "Immobilier tertiaire",
        "address": {
            "zipcode": "75015",
            "city": "Paris",
            "country": "FRA"
        },
        "created_at": "2023-07-20 13:58:30",
        "name": "Immo Paris",
        "parent_network_id": null,
        "rgpd": 1
    },
    "meta": {
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "account",
            "name": "My account"
        },
        "total": 1
    }
}

Update an account

PUT

PATCH

https://api.magnetis.io

/accounts/{id}

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

slug

string

required

The id of the account.

Example:

acc-6e64b651-026a-46de-ab3e-944a193945a9

Body Parameters

activity

string

Example:

Automobile

city

string

The account city

Example:

Paris

country

string

The account country

Example:

FRA

name

string

The account name

Example:

My account

parent_network_id

string

The account parent network

Example:

net-XXX

rgpd

string

The account RGPD setting

Example:

zipcode

string

The account zipcode

Example:

75000

Response Fields

string

The unique ID of the account

activity

string

address

object

Account address informations

created_at

datetime

Creation datetime of the account. Format: YYYY-MM-DD HH:mm:ss

name

string

Account name

parent_network_id

string|null

The unique ID of the network in which the account is

rgpd

string

RGPD settings of the account. Enum: 1 (All calling numbers are truncated), 2 (Only calling numbers from missed calls are fully displayed), 3 (All calling number are fully displayed)

Example request:

curl --request PUT \
    "https://api.magnetis.io/accounts/1" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"activity\": \"Automobile\",
    \"city\": \"Paris\",
    \"country\": \"FRA\",
    \"name\": \"My account\",
    \"parent_network_id\": \"net-XXX\",
    \"rgpd\": \"2\",
    \"zipcode\": \"75000\"
}"

Example response:

{
    "data": {
        "id": "acc-f27c03a5-9498-4dd1-aeeb-30722b219f2e",
        "activity": "Immobilier tertiaire",
        "address": {
            "zipcode": "75015",
            "city": "Paris",
            "country": "FRA"
        },
        "created_at": "2023-07-20 13:58:30",
        "name": "Immo Paris",
        "parent_network_id": null,
        "rgpd": 1
    },
    "meta": {
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "account",
            "name": "My account"
        },
        "total": 1
    }
}

Delete an account

DELETE

https://api.magnetis.io

/accounts/{id}

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

slug

string

required

The id of the account.

Example:

acc-6e64b651-026a-46de-ab3e-944a193945a9

Response Fields

string

The unique ID of the account

activity

string

address

object

Account address informations

created_at

datetime

Creation datetime of the account. Format: YYYY-MM-DD HH:mm:ss

name

string

Account name

parent_network_id

string|null

The unique ID of the network in which the account is

rgpd

string

RGPD settings of the account. Enum: 1 (All calling numbers are truncated), 2 (Only calling numbers from missed calls are fully displayed), 3 (All calling number are fully displayed)

Example request:

curl --request DELETE \
    "https://api.magnetis.io/accounts/1" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": {
        "id": "acc-f27c03a5-9498-4dd1-aeeb-30722b219f2e",
        "activity": "Immobilier tertiaire",
        "address": {
            "zipcode": "75015",
            "city": "Paris",
            "country": "FRA"
        },
        "created_at": "2023-07-20 13:58:30",
        "name": "Immo Paris",
        "parent_network_id": null,
        "rgpd": 1
    },
    "meta": {
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "account",
            "name": "My account"
        },
        "total": 1
    }
}

Authentication

Get API key informations

GET

https://api.magnetis.io

/auth

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

Response Fields

string

The unique ID of the API key

created_at

datetime

Creation datetime of the API key. Format: YYYY-MM-DD HH:mm:ss

expiration

datetime

Expiration datetime of the API key. Format: YYYY-MM-DD HH:mm:ss

level

string

Architecture level of the API key. Enum: account, network, organization

name

string

API key name

Example request:

curl --request GET \
    --get "https://api.magnetis.io/auth" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": {
        "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
        "created_at": "2023-07-25 12:00:00",
        "expiration": null,
        "level": "account",
        "name": "My account"
    },
    "meta": {
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "account",
            "name": "My account"
        },
        "total": 1
    }
}

Calls

List all calls

GET

https://api.magnetis.io

/calls

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

from

Optional. From date. 7 days ago if not set.

Example:

20230601000000

limit

Optional. Result per page. 250 if not set.

Example:

250

page

Optional. Pagination page. 1 if not set.

Example:

number_id

Optional. Filter by number ID.

Example:

num-XXX

Optional. To date. Now if not set.

Example:

20230607235959

calling_number

Optional. Calling number filter at international format.

Example:

0033612345678

actions

Optional. Allows you to display post-call actions when equals to 1.

Example:

Response Fields

string

The unique ID of the call

account

object

Account in which the call was made

actions

object

The actions made after the call. Present only with parameter actions equal to 1

gads

object[]

Google Ads conversions

conversion_action_name

string

Google Ads conversion action name

conversion_action_id

string

Google Ads conversion action ID

date

datetime

Date the conversion was initiated. Format: YYYY-MM-DD HH:mm:ss

done_at

datetime|null

Date the conversion was pushed to Google Ads. Format: YYYY-MM-DD HH:mm:ss

response

string|null

Google Ads response in case of error

status

string

Conversion status. Enum: done, failed, retry, waiting

value

integer

Conversion value.

gads_extensions

object[]

Google Ads extensions conversions

conversion_action_name

string

Google Ads call conversion action name

conversion_action_id

string

Google Ads call conversion action ID

date

datetime

Date the conversion was initiated. Format: YYYY-MM-DD HH:mm:ss

done_at

datetime|null

Date the conversion was pushed to Google Ads. Format: YYYY-MM-DD HH:mm:ss

response

string|null

Google Ads response in case of error

status

string

Conversion status. Enum: done, failed, retry, waiting

value

integer

Conversion value.

ga4

object[]

GA4 events

matomo

object[]

Matomo events

category

string

Matomo event category

action

string

Matomo event action

name

string

Matomo event name

date

datetime

Date the event was initiated. Format: YYYY-MM-DD HH:mm:ss

done_at

datetime|null

Date the event was pushed to Matomo. Format: YYYY-MM-DD HH:mm:ss

status

string

Event status. Enum: done, failed, retry, waiting

value

integer

Event value

webhook

object[]

Webhook pushes

calling_country

string

Country of the caller. Enum: FRA, ESP, DEU, ITA

calling_number

string

Number of the caller

calling_type

string

Type of the caller. Enum: mobile, geographic, national, special

channel_name

string

Tracking channel name

channel_type

string

Tracking channel type. Enum: googleads, googleadsextension, bingads, sea, google, bing, seo, website, googlemybusiness, externalwebsite, landingpage, emailing, referrer, direct, sms, application, banner, vms, storelocator, linkedin, facebook, twitter, instagram, social, flyer, poster, businesscard, print, press, billboard, magazine, pagesjaunes, leboncoin, logicimmo, seloger, bienici, paruvendu, ouestfrance, explorimo, meilleursagents, avendrealouer, fnaim, lacentrale, largus, event, lead, other, bridge

date

datetime

Date of the call. Format: YYYY-MM-DD HH:mm:ss

duration

integer

Duration of the call in seconds

end_date

datetime

Technical end date of the call flow. Format: YYYY-MM-DD HH:mm:ss

end_status

string

Status of the call forwarding to the recipient number. Enum: completed, no-answer, busy, canceled, failed

events

string

Timeline of the call

firsttime_caller

boolean

Check if this call is the first call of the caller number in this account

flow_status

string

Only for live monitoring. Provide the current status of the call. Enum: initiated, ringing, in-progress, completed

google_ads_extension

object|null

Google Ads extension informations

customer_id

string

Extension customer ID

customer_name

string

Extension customer name

campaign_id

string

Extension campaign ID

campaign_name

string

Extension campaign name

ad_group_id

string

Extension ad group ID

ad_group_name

string

Extension ad group name

missed

boolean

Check if the call is missed

number_id

string

The unique ID of the tracked number

pool_id

string

The unique ID of the pool which contains the tracked number

recipient_number

string

Number of the end recipient

recording

string

Link to download the recording file. If you are in whitelabel, you can replace domain in the URL.

tracked_country

string

Country of the tracked number

tracked_number

string

Tracked number

tracked_type

string

Type of the tracked number. Enum: mobile, geographic, national, special

voice_duration

integer

End termination voice duration in seconds

visitor

object|null

The caller website visit

condition_name

string

Condition name of the visitor website entry

condition_type

string

Condition type of the visitor website entry

custom_cookies

string[]

Custom cookies collected on the visitor website entry

custom_variables

string[]

Custom variables collected on the visitor website entry

custom_local_storage

string[]

Custom local storage variables collected on the visitor website entry

custom_params

string[]

Custom URL parameters collected on the visitor website entry

_ga

string

GA4 ID collected on the visitor website entry

_pk_id

string

Matomo ID collected on the visitor website entry

gclid

string

Google Ads ID collected on the visitor website entry

gbraid

string

Google Ads ID collected on the visitor website entry

msclkid

string

Msclkid collected on the visitor website entry

wbraid

string

Google Ads ID collected on the visitor website entry

utm

string[]

UTMs collected on the visitor website entry

valuetrack

string[]

ValueTrack collected on the visitor website entry

3rdparty

string[]

3rdparty parameters collected on the visitor website entry

Example request:

curl --request GET \
    --get "https://api.magnetis.io/calls" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [
        {
            "id": "call-0c5ac87f-6d8b-4e94-9ce2-f4773bced2f5",
            "account": {
                "id": "acc-efd1bbeb-afbb-4895-a6d5-40a13558af49",
                "name": "My account"
            },
            "calling_country": "FRA",
            "calling_number": "0033612345678",
            "calling_type": "mobile",
            "channel_name": "Google Ads",
            "channel_type": "googleads",
            "date": "2023-08-30 13:57:30",
            "duration": 43,
            "end_date": "2023-08-30 13:58:13",
            "end_status": "completed",
            "events": [
                {
                    "date": "2023-08-30 13:57:30",
                    "name": "call:in",
                    "value": null
                },
                {
                    "date": "2023-08-30 13:57:31",
                    "name": "call:out",
                    "value": "0033687654321"
                },
                {
                    "date": "2023-08-30 13:57:33",
                    "name": "call:ringing",
                    "value": "0033687654321"
                },
                {
                    "date": "2023-08-30 13:57:48",
                    "name": "call:answered",
                    "value": "0033687654321"
                },
                {
                    "date": "2023-08-30 13:58:13",
                    "name": "call:completed",
                    "value": "no-answer"
                }
            ],
            "firsttime_caller": true,
            "flow_status": "completed",
            "google_ads_extension": null,
            "missed": false,
            "number_id": "num-18dd0fdb-7f21-4999-9335-a5d50d8c716e",
            "pool_id": "pul-c8c7912c-5e3e-4b19-8769-4daadea66dea",
            "recipient_number": "0033687654321",
            "tracked_country": "FRA",
            "tracked_number": "0033412345678",
            "tracked_type": "geographic",
            "voice_duration": 43,
            "visitor": {
                "condition_name": "Google Ads",
                "condition_type": "google_ads",
                "custom_cookies": [],
                "custom_local_storage": [],
                "custom_params": [],
                "custom_variables": [],
                "ga": "GA1.1.12345678.87654321",
                "gclid": "EAIaIQobChER4_LZnaeJ4gIV3EdFFh2raA5aEAAYAiAAEgKyCF3_BwE",
                "gbraid": null,
                "msclkid": null,
                "utm": [
                    {
                        "key": "utm_source",
                        "value": "googleads"
                    }
                ],
                "valuetrack": [],
                "wbraid": null,
                "3rdparty": []
            }
        },
        {
            "id": "call-a9dec6da-1fdf-4e33-ba0e-e7c8d20e1edb",
            "account": {
                "id": "acc-efd1bbeb-afbb-4895-a6d5-40a13558af49",
                "name": "My account"
            },
            "calling_country": "FRA",
            "calling_number": "0033911774499",
            "calling_type": "geographic",
            "channel_name": "SEO",
            "channel_type": "seo",
            "date": "2023-08-30 10:05:53",
            "duration": 302,
            "end_date": "2023-08-30 10:10:55",
            "end_status": "completed",
            "events": [
                {
                    "date": "2023-08-30 10:05:53",
                    "name": "call:in",
                    "value": null
                },
                {
                    "date": "2023-08-30 10:05:54",
                    "name": "call:out",
                    "value": "0033687654321"
                },
                {
                    "date": "2023-08-30 10:05:55",
                    "name": "call:ringing",
                    "value": "0033687654321"
                },
                {
                    "date": "2023-08-30 10:06:03",
                    "name": "call:answered",
                    "value": "0033687654321"
                },
                {
                    "date": "2023-08-30 10:10:55",
                    "name": "call:completed",
                    "value": "completed"
                }
            ],
            "firsttime_caller": false,
            "flow_status": "completed",
            "google_ads_extension": null,
            "missed": false,
            "number_id": "num-583a97ac-eeef-4d18-bede-56c67e29c1cb",
            "pool_id": null,
            "recipient_number": "0033687654321",
            "tracked_country": "FRA",
            "tracked_number": "0033488554422",
            "tracked_type": "geographic",
            "voice_duration": 292,
            "visitor": null
        },
        {
            "id": "call-b7831876-641f-43c3-b70f-5f51a2750a14",
            "account": {
                "id": "acc-efd1bbeb-afbb-4895-a6d5-40a13558af49",
                "name": "My account"
            },
            "calling_country": "FRA",
            "calling_number": "0033643215678",
            "calling_type": "mobile",
            "channel_name": "Extensions Google Ads",
            "channel_type": "googleadsextension",
            "date": "2023-08-30 09:30:05",
            "duration": 5,
            "end_date": "2023-08-30 09:30:10",
            "end_status": "no-answer",
            "events": [
                {
                    "date": "2023-08-30 09:30:05",
                    "name": "call:in",
                    "value": null
                },
                {
                    "date": "2023-08-30 09:30:06",
                    "name": "call:out",
                    "value": "0033687654321"
                },
                {
                    "date": "2023-08-30 09:30:07",
                    "name": "call:ringing",
                    "value": "0033687654321"
                },
                {
                    "date": "2023-08-30 09:30:10",
                    "name": "call:completed",
                    "value": "completed"
                }
            ],
            "firsttime_caller": true,
            "flow_status": "completed",
            "google_ads_extension": {
                "customer_id": "123-456-7890",
                "customer_name": "My Google Ads account",
                "campaign_id": "123456789012",
                "campaign_name": "My campaign",
                "ad_group_id": "098765432109",
                "ad_group_name": "My ad group"
            },
            "missed": true,
            "number_id": "num-0c1aa069-896b-44b1-83c9-a41c3ea6daa9",
            "pool_id": null,
            "recipient_number": "0033644332211",
            "tracked_country": "FRA",
            "tracked_number": "0033411223344",
            "tracked_type": "geographic",
            "voice_duration": 5,
            "visitor": null
        }
    ],
    "links": {
        "first": "https://api.magnetis.io/calls?page=1",
        "last": "https://api.magnetis.io/calls?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "path": "https://api.magnetis.io/calls",
        "per_page": 500,
        "to": 3,
        "total": 3,
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "account",
            "name": "My account"
        }
    }
}

Fetch a call

GET

https://api.magnetis.io

/calls/{id}

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

string

required

The ID of the call.

Example:

call-50e4003c-e072-4b3d-b0db-ef8dd9a2949a

actions

Optional. Allows you to display post-call actions when equals to 1.

Example:

Response Fields

string

The unique ID of the call

account

object

Account in which the call was made

actions

object

The actions made after the call. Present only with parameter actions equal to 1

gads

object[]

Google Ads conversions

conversion_action_name

string

Google Ads conversion action name

conversion_action_id

string

Google Ads conversion action ID

date

datetime

Date the conversion was initiated. Format: YYYY-MM-DD HH:mm:ss

done_at

datetime|null

Date the conversion was pushed to Google Ads. Format: YYYY-MM-DD HH:mm:ss

response

string|null

Google Ads response in case of error

status

string

Conversion status. Enum: done, failed, retry, waiting

value

integer

Conversion value.

gads_extensions

object[]

Google Ads extensions conversions

conversion_action_name

string

Google Ads call conversion action name

conversion_action_id

string

Google Ads call conversion action ID

date

datetime

Date the conversion was initiated. Format: YYYY-MM-DD HH:mm:ss

done_at

datetime|null

Date the conversion was pushed to Google Ads. Format: YYYY-MM-DD HH:mm:ss

response

string|null

Google Ads response in case of error

status

string

Conversion status. Enum: done, failed, retry, waiting

value

integer

Conversion value.

ga4

object[]

GA4 events

matomo

object[]

Matomo events

category

string

Matomo event category

action

string

Matomo event action

name

string

Matomo event name

date

datetime

Date the event was initiated. Format: YYYY-MM-DD HH:mm:ss

done_at

datetime|null

Date the event was pushed to Matomo. Format: YYYY-MM-DD HH:mm:ss

status

string

Event status. Enum: done, failed, retry, waiting

value

integer

Event value

webhook

object[]

Webhook pushes

calling_country

string

Country of the caller. Enum: FRA, ESP, DEU, ITA

calling_number

string

Number of the caller

calling_type

string

Type of the caller. Enum: mobile, geographic, national, special

channel_name

string

Tracking channel name

channel_type

string

date

datetime

Date of the call. Format: YYYY-MM-DD HH:mm:ss

duration

integer

Duration of the call in seconds

end_date

datetime

Technical end date of the call flow. Format: YYYY-MM-DD HH:mm:ss

end_status

string

Status of the call forwarding to the recipient number. Enum: completed, no-answer, busy, canceled, failed

events

string

Timeline of the call

firsttime_caller

boolean

Check if this call is the first call of the caller number in this account

flow_status

string

Only for live monitoring. Provide the current status of the call. Enum: initiated, ringing, in-progress, completed

google_ads_extension

object|null

Google Ads extension informations

customer_id

string

Extension customer ID

customer_name

string

Extension customer name

campaign_id

string

Extension campaign ID

campaign_name

string

Extension campaign name

ad_group_id

string

Extension ad group ID

ad_group_name

string

Extension ad group name

missed

boolean

Check if the call is missed

number_id

string

The unique ID of the tracked number

pool_id

string

The unique ID of the pool which contains the tracked number

recipient_number

string

Number of the end recipient

recording

string

Link to download the recording file. If you are in whitelabel, you can replace domain in the URL.

tracked_country

string

Country of the tracked number

tracked_number

string

Tracked number

tracked_type

string

Type of the tracked number. Enum: mobile, geographic, national, special

voice_duration

integer

End termination voice duration in seconds

visitor

object|null

The caller website visit

condition_name

string

Condition name of the visitor website entry

condition_type

string

Condition type of the visitor website entry

custom_cookies

string[]

Custom cookies collected on the visitor website entry

custom_variables

string[]

Custom variables collected on the visitor website entry

custom_local_storage

string[]

Custom local storage variables collected on the visitor website entry

custom_params

string[]

Custom URL parameters collected on the visitor website entry

_ga

string

GA4 ID collected on the visitor website entry

_pk_id

string

Matomo ID collected on the visitor website entry

gclid

string

Google Ads ID collected on the visitor website entry

gbraid

string

Google Ads ID collected on the visitor website entry

msclkid

string

Msclkid collected on the visitor website entry

wbraid

string

Google Ads ID collected on the visitor website entry

utm

string[]

UTMs collected on the visitor website entry

valuetrack

string[]

ValueTrack collected on the visitor website entry

3rdparty

string[]

3rdparty parameters collected on the visitor website entry

Example request:

curl --request GET \
    --get "https://api.magnetis.io/calls/call-50e4003c-e072-4b3d-b0db-ef8dd9a2949a" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": {
        "id": "call-0c5ac87f-6d8b-4e94-9ce2-f4773bced2f5",
        "account": {
            "id": "acc-efd1bbeb-afbb-4895-a6d5-40a13558af49",
            "name": "My account"
        },
        "calling_country": "FRA",
        "calling_number": "0033612345678",
        "calling_type": "mobile",
        "channel_name": "Google Ads",
        "channel_type": "googleads",
        "date": "2023-08-30 13:57:30",
        "duration": 43,
        "end_date": "2023-08-30 13:58:13",
        "end_status": "completed",
        "events": [
            {
                "date": "2023-08-30 13:57:30",
                "name": "call:in",
                "value": null
            },
            {
                "date": "2023-08-30 13:57:31",
                "name": "call:out",
                "value": "0033687654321"
            },
            {
                "date": "2023-08-30 13:57:33",
                "name": "call:ringing",
                "value": "0033687654321"
            },
            {
                "date": "2023-08-30 13:57:48",
                "name": "call:answered",
                "value": "0033687654321"
            },
            {
                "date": "2023-08-30 13:58:13",
                "name": "call:completed",
                "value": "no-answer"
            }
        ],
        "firsttime_caller": true,
        "flow_status": "completed",
        "google_ads_extension": null,
        "missed": false,
        "number_id": "num-18dd0fdb-7f21-4999-9335-a5d50d8c716e",
        "pool_id": "pul-c8c7912c-5e3e-4b19-8769-4daadea66dea",
        "recipient_number": "0033687654321",
        "tracked_country": "FRA",
        "tracked_number": "0033412345678",
        "tracked_type": "geographic",
        "voice_duration": 43,
        "visitor": {
            "condition_name": "Google Ads",
            "condition_type": "google_ads",
            "custom_cookies": [],
            "custom_local_storage": [],
            "custom_params": [],
            "custom_variables": [],
            "ga": "GA1.1.12345678.87654321",
            "gclid": "EAIaIQobChER4_LZnaeJ4gIV3EdFFh2raA5aEAAYAiAAEgKyCF3_BwE",
            "gbraid": null,
            "msclkid": null,
            "utm": [
                {
                    "key": "utm_source",
                    "value": "googleads"
                }
            ],
            "valuetrack": [],
            "wbraid": null,
            "3rdparty": []
        }
    },
    "meta": {
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "account",
            "name": "My account"
        },
        "total": 1
    }
}

Upload conversion for Google Ads Extension call

POST

https://api.magnetis.io

/calls/{id}/extension_conversion

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

string

required

The ID of the call.

Example:

call-50e4003c-e072-4b3d-b0db-ef8dd9a2949a

Body Parameters

conversion_action

string

required

The Google Ads conversion action in which to upload the conversion. It must exist in the Google Ads account.

Example:

Rendez-vous qualifié

value

string

required

The conversion value. Must be equal or greater than 0.

Example:

Response Fields

string

The unique ID of the call

account

object

Account in which the call was made

actions

object

The actions made after the call. Present only with parameter actions equal to 1

gads

object[]

Google Ads conversions

conversion_action_name

string

Google Ads conversion action name

conversion_action_id

string

Google Ads conversion action ID

date

datetime

Date the conversion was initiated. Format: YYYY-MM-DD HH:mm:ss

done_at

datetime|null

Date the conversion was pushed to Google Ads. Format: YYYY-MM-DD HH:mm:ss

response

string|null

Google Ads response in case of error

status

string

Conversion status. Enum: done, failed, retry, waiting

value

integer

Conversion value.

gads_extensions

object[]

Google Ads extensions conversions

conversion_action_name

string

Google Ads call conversion action name

conversion_action_id

string

Google Ads call conversion action ID

date

datetime

Date the conversion was initiated. Format: YYYY-MM-DD HH:mm:ss

done_at

datetime|null

Date the conversion was pushed to Google Ads. Format: YYYY-MM-DD HH:mm:ss

response

string|null

Google Ads response in case of error

status

string

Conversion status. Enum: done, failed, retry, waiting

value

integer

Conversion value.

ga4

object[]

GA4 events

matomo

object[]

Matomo events

category

string

Matomo event category

action

string

Matomo event action

name

string

Matomo event name

date

datetime

Date the event was initiated. Format: YYYY-MM-DD HH:mm:ss

done_at

datetime|null

Date the event was pushed to Matomo. Format: YYYY-MM-DD HH:mm:ss

status

string

Event status. Enum: done, failed, retry, waiting

value

integer

Event value

webhook

object[]

Webhook pushes

calling_country

string

Country of the caller. Enum: FRA, ESP, DEU, ITA

calling_number

string

Number of the caller

calling_type

string

Type of the caller. Enum: mobile, geographic, national, special

channel_name

string

Tracking channel name

channel_type

string

date

datetime

Date of the call. Format: YYYY-MM-DD HH:mm:ss

duration

integer

Duration of the call in seconds

end_date

datetime

Technical end date of the call flow. Format: YYYY-MM-DD HH:mm:ss

end_status

string

Status of the call forwarding to the recipient number. Enum: completed, no-answer, busy, canceled, failed

events

string

Timeline of the call

firsttime_caller

boolean

Check if this call is the first call of the caller number in this account

flow_status

string

Only for live monitoring. Provide the current status of the call. Enum: initiated, ringing, in-progress, completed

google_ads_extension

object|null

Google Ads extension informations

customer_id

string

Extension customer ID

customer_name

string

Extension customer name

campaign_id

string

Extension campaign ID

campaign_name

string

Extension campaign name

ad_group_id

string

Extension ad group ID

ad_group_name

string

Extension ad group name

missed

boolean

Check if the call is missed

number_id

string

The unique ID of the tracked number

pool_id

string

The unique ID of the pool which contains the tracked number

recipient_number

string

Number of the end recipient

recording

string

Link to download the recording file. If you are in whitelabel, you can replace domain in the URL.

tracked_country

string

Country of the tracked number

tracked_number

string

Tracked number

tracked_type

string

Type of the tracked number. Enum: mobile, geographic, national, special

voice_duration

integer

End termination voice duration in seconds

visitor

object|null

The caller website visit

condition_name

string

Condition name of the visitor website entry

condition_type

string

Condition type of the visitor website entry

custom_cookies

string[]

Custom cookies collected on the visitor website entry

custom_variables

string[]

Custom variables collected on the visitor website entry

custom_local_storage

string[]

Custom local storage variables collected on the visitor website entry

custom_params

string[]

Custom URL parameters collected on the visitor website entry

_ga

string

GA4 ID collected on the visitor website entry

_pk_id

string

Matomo ID collected on the visitor website entry

gclid

string

Google Ads ID collected on the visitor website entry

gbraid

string

Google Ads ID collected on the visitor website entry

msclkid

string

Msclkid collected on the visitor website entry

wbraid

string

Google Ads ID collected on the visitor website entry

utm

string[]

UTMs collected on the visitor website entry

valuetrack

string[]

ValueTrack collected on the visitor website entry

3rdparty

string[]

3rdparty parameters collected on the visitor website entry

Example request:

curl --request POST \
    "https://api.magnetis.io/calls/call-50e4003c-e072-4b3d-b0db-ef8dd9a2949a/extension_conversion" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"conversion_action\": \"Rendez-vous qualifié\",
    \"value\": \"0\"
}"

Example response:

{
    "error": "Confirmation message",
    "data": []
}

Update conversion value for Google Ads visitor call

PUT

https://api.magnetis.io

/calls/{id}/visitor_conversion

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

string

required

The ID of the call.

Example:

call-50e4003c-e072-4b3d-b0db-ef8dd9a2949a

Body Parameters

value

string

required

The conversion value. Must be equal or greater than 0.

Example:

Response Fields

string

The unique ID of the call

account

object

Account in which the call was made

actions

object

The actions made after the call. Present only with parameter actions equal to 1

gads

object[]

Google Ads conversions

conversion_action_name

string

Google Ads conversion action name

conversion_action_id

string

Google Ads conversion action ID

date

datetime

Date the conversion was initiated. Format: YYYY-MM-DD HH:mm:ss

done_at

datetime|null

Date the conversion was pushed to Google Ads. Format: YYYY-MM-DD HH:mm:ss

response

string|null

Google Ads response in case of error

status

string

Conversion status. Enum: done, failed, retry, waiting

value

integer

Conversion value.

gads_extensions

object[]

Google Ads extensions conversions

conversion_action_name

string

Google Ads call conversion action name

conversion_action_id

string

Google Ads call conversion action ID

date

datetime

Date the conversion was initiated. Format: YYYY-MM-DD HH:mm:ss

done_at

datetime|null

Date the conversion was pushed to Google Ads. Format: YYYY-MM-DD HH:mm:ss

response

string|null

Google Ads response in case of error

status

string

Conversion status. Enum: done, failed, retry, waiting

value

integer

Conversion value.

ga4

object[]

GA4 events

matomo

object[]

Matomo events

category

string

Matomo event category

action

string

Matomo event action

name

string

Matomo event name

date

datetime

Date the event was initiated. Format: YYYY-MM-DD HH:mm:ss

done_at

datetime|null

Date the event was pushed to Matomo. Format: YYYY-MM-DD HH:mm:ss

status

string

Event status. Enum: done, failed, retry, waiting

value

integer

Event value

webhook

object[]

Webhook pushes

calling_country

string

Country of the caller. Enum: FRA, ESP, DEU, ITA

calling_number

string

Number of the caller

calling_type

string

Type of the caller. Enum: mobile, geographic, national, special

channel_name

string

Tracking channel name

channel_type

string

date

datetime

Date of the call. Format: YYYY-MM-DD HH:mm:ss

duration

integer

Duration of the call in seconds

end_date

datetime

Technical end date of the call flow. Format: YYYY-MM-DD HH:mm:ss

end_status

string

Status of the call forwarding to the recipient number. Enum: completed, no-answer, busy, canceled, failed

events

string

Timeline of the call

firsttime_caller

boolean

Check if this call is the first call of the caller number in this account

flow_status

string

Only for live monitoring. Provide the current status of the call. Enum: initiated, ringing, in-progress, completed

google_ads_extension

object|null

Google Ads extension informations

customer_id

string

Extension customer ID

customer_name

string

Extension customer name

campaign_id

string

Extension campaign ID

campaign_name

string

Extension campaign name

ad_group_id

string

Extension ad group ID

ad_group_name

string

Extension ad group name

missed

boolean

Check if the call is missed

number_id

string

The unique ID of the tracked number

pool_id

string

The unique ID of the pool which contains the tracked number

recipient_number

string

Number of the end recipient

recording

string

Link to download the recording file. If you are in whitelabel, you can replace domain in the URL.

tracked_country

string

Country of the tracked number

tracked_number

string

Tracked number

tracked_type

string

Type of the tracked number. Enum: mobile, geographic, national, special

voice_duration

integer

End termination voice duration in seconds

visitor

object|null

The caller website visit

condition_name

string

Condition name of the visitor website entry

condition_type

string

Condition type of the visitor website entry

custom_cookies

string[]

Custom cookies collected on the visitor website entry

custom_variables

string[]

Custom variables collected on the visitor website entry

custom_local_storage

string[]

Custom local storage variables collected on the visitor website entry

custom_params

string[]

Custom URL parameters collected on the visitor website entry

_ga

string

GA4 ID collected on the visitor website entry

_pk_id

string

Matomo ID collected on the visitor website entry

gclid

string

Google Ads ID collected on the visitor website entry

gbraid

string

Google Ads ID collected on the visitor website entry

msclkid

string

Msclkid collected on the visitor website entry

wbraid

string

Google Ads ID collected on the visitor website entry

utm

string[]

UTMs collected on the visitor website entry

valuetrack

string[]

ValueTrack collected on the visitor website entry

3rdparty

string[]

3rdparty parameters collected on the visitor website entry

Example request:

curl --request PUT \
    "https://api.magnetis.io/calls/call-50e4003c-e072-4b3d-b0db-ef8dd9a2949a/visitor_conversion" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"value\": \"0\"
}"

Example response:

{
    "error": "Confirmation message",
    "data": []
}

Delete conversion for Google Ads visitor call

DELETE

https://api.magnetis.io

/calls/{id}/visitor_conversion

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

string

required

The ID of the call.

Example:

call-50e4003c-e072-4b3d-b0db-ef8dd9a2949a

Response Fields

string

The unique ID of the call

account

object

Account in which the call was made

actions

object

The actions made after the call. Present only with parameter actions equal to 1

gads

object[]

Google Ads conversions

conversion_action_name

string

Google Ads conversion action name

conversion_action_id

string

Google Ads conversion action ID

date

datetime

Date the conversion was initiated. Format: YYYY-MM-DD HH:mm:ss

done_at

datetime|null

Date the conversion was pushed to Google Ads. Format: YYYY-MM-DD HH:mm:ss

response

string|null

Google Ads response in case of error

status

string

Conversion status. Enum: done, failed, retry, waiting

value

integer

Conversion value.

gads_extensions

object[]

Google Ads extensions conversions

conversion_action_name

string

Google Ads call conversion action name

conversion_action_id

string

Google Ads call conversion action ID

date

datetime

Date the conversion was initiated. Format: YYYY-MM-DD HH:mm:ss

done_at

datetime|null

Date the conversion was pushed to Google Ads. Format: YYYY-MM-DD HH:mm:ss

response

string|null

Google Ads response in case of error

status

string

Conversion status. Enum: done, failed, retry, waiting

value

integer

Conversion value.

ga4

object[]

GA4 events

matomo

object[]

Matomo events

category

string

Matomo event category

action

string

Matomo event action

name

string

Matomo event name

date

datetime

Date the event was initiated. Format: YYYY-MM-DD HH:mm:ss

done_at

datetime|null

Date the event was pushed to Matomo. Format: YYYY-MM-DD HH:mm:ss

status

string

Event status. Enum: done, failed, retry, waiting

value

integer

Event value

webhook

object[]

Webhook pushes

calling_country

string

Country of the caller. Enum: FRA, ESP, DEU, ITA

calling_number

string

Number of the caller

calling_type

string

Type of the caller. Enum: mobile, geographic, national, special

channel_name

string

Tracking channel name

channel_type

string

date

datetime

Date of the call. Format: YYYY-MM-DD HH:mm:ss

duration

integer

Duration of the call in seconds

end_date

datetime

Technical end date of the call flow. Format: YYYY-MM-DD HH:mm:ss

end_status

string

Status of the call forwarding to the recipient number. Enum: completed, no-answer, busy, canceled, failed

events

string

Timeline of the call

firsttime_caller

boolean

Check if this call is the first call of the caller number in this account

flow_status

string

Only for live monitoring. Provide the current status of the call. Enum: initiated, ringing, in-progress, completed

google_ads_extension

object|null

Google Ads extension informations

customer_id

string

Extension customer ID

customer_name

string

Extension customer name

campaign_id

string

Extension campaign ID

campaign_name

string

Extension campaign name

ad_group_id

string

Extension ad group ID

ad_group_name

string

Extension ad group name

missed

boolean

Check if the call is missed

number_id

string

The unique ID of the tracked number

pool_id

string

The unique ID of the pool which contains the tracked number

recipient_number

string

Number of the end recipient

recording

string

Link to download the recording file. If you are in whitelabel, you can replace domain in the URL.

tracked_country

string

Country of the tracked number

tracked_number

string

Tracked number

tracked_type

string

Type of the tracked number. Enum: mobile, geographic, national, special

voice_duration

integer

End termination voice duration in seconds

visitor

object|null

The caller website visit

condition_name

string

Condition name of the visitor website entry

condition_type

string

Condition type of the visitor website entry

custom_cookies

string[]

Custom cookies collected on the visitor website entry

custom_variables

string[]

Custom variables collected on the visitor website entry

custom_local_storage

string[]

Custom local storage variables collected on the visitor website entry

custom_params

string[]

Custom URL parameters collected on the visitor website entry

_ga

string

GA4 ID collected on the visitor website entry

_pk_id

string

Matomo ID collected on the visitor website entry

gclid

string

Google Ads ID collected on the visitor website entry

gbraid

string

Google Ads ID collected on the visitor website entry

msclkid

string

Msclkid collected on the visitor website entry

wbraid

string

Google Ads ID collected on the visitor website entry

utm

string[]

UTMs collected on the visitor website entry

valuetrack

string[]

ValueTrack collected on the visitor website entry

3rdparty

string[]

3rdparty parameters collected on the visitor website entry

Example request:

curl --request DELETE \
    "https://api.magnetis.io/calls/call-50e4003c-e072-4b3d-b0db-ef8dd9a2949a/visitor_conversion" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "error": "Confirmation message",
    "data": []
}

Email-tracking

Emails

List all received emails

GET

https://api.magnetis.io

/emails

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

from

Optional. From date. 7 days ago if not set.

Example:

20230601000000

limit

Optional. Result per page. 250 if not set.

Example:

250

page

Optional. Pagination page. 1 if not set.

Example:

Optional. To date. Now if not set.

Example:

20230607235959

type

Optional. Email filter: match, unmatch, all. Match if not set.

Example:

match

Response Fields

string

The unique ID of the email

account

string

Account with emailtracking in which the email was sent

channel_name

string

Email-tracking channel name

channel_type

string

Email-tracking channel type

date

datetime

Date of the email. Format: YYYY-MM-DD HH:mm:ss

from_email

integer

Sender's email address

from_name

string

Sender's name

is_spam

boolean

Check if the call is spam

lead

string

Lead created by the parsing feature

string

The unique ID of the lead

call_id

?string

Call from wich the lead was created

created_at

datetime

Creation date of the lead. Format: YYYY-MM-DD HH:mm:ss

email_id

string

Email from wich the lead was created

fields

object

Object paired with key = label and value = value

landing_page

object

Landing Page from wich the lead was created

source

string

Source name from wich the lead come

subject

string

Subject of the email

tracked_email

string

The tracked email address

string[]

Original recipients of the email

Example request:

curl --request GET \
    --get "https://api.magnetis.io/emails" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [
        {
            "id": "etm-4908be34-1489-4806-85f6-11bf12ea13ce",
            "account": {
                "id": "acc-250ce1bd-237d-4e2d-aa17-51293760a801",
                "name": "Artisan Lyon"
            },
            "channel_name": "LeBonCoin",
            "channel_type": "leboncoin",
            "date": "2023-09-25 14:50:12",
            "from_email": "jane.doe@gmail.com",
            "from_name": "Jane Doe",
            "is_spam": false,
            "lead": {
                "id": "lead-9c6187a3-9865-418d-be80-e45d5990f039",
                "call_id": null,
                "created_at": "2023-09-25 14:50:12",
                "email_id": "etm-4908be34-1489-4806-85f6-11bf12ea13ce",
                "fields": {
                    "firstname": "Jane",
                    "lastname": "Doe",
                    "phone": null,
                    "email": "jane.doe@gmail.com",
                    "zipcode": null
                },
                "landing_page": {
                    "title": null,
                    "url": null
                },
                "source": "email"
            },
            "subject": "Nouveau message sur votre annonce",
            "tracked_email": "acc.99999.track@mgtmail.fr",
            "to": "entreprise@monemail.com"
        },
        {
            "id": "etm-1775b79c-95b0-41f3-844a-3bb2437b25d1",
            "account": {
                "id": "acc-66db2b07-073e-40ca-ab82-cc9b7e652bd0",
                "name": "Artisan Lille"
            },
            "channel_name": "Se Loger",
            "channel_type": "seloger",
            "date": "2023-09-25 14:50:12",
            "from_email": "john@gmail.com",
            "from_name": "John Doe",
            "is_spam": false,
            "lead": null,
            "subject": "Nouveau prospect",
            "tracked_email": "acc.99998.track@mgtmail.fr",
            "to": "entreprise@monemail.com"
        }
    ],
    "links": {
        "first": "https://api.magnetis.io/emails?page=1",
        "last": "https://api.magnetis.io/emails?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "path": "https://api.magnetis.io/emails",
        "per_page": 250,
        "to": 2,
        "total": 2,
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "account",
            "name": "My account"
        }
    }
}

Fetch a received email

GET

https://api.magnetis.io

/emails/{id}

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

slug

string

required

The id of the email.

Example:

etm-49a6306b-64c6-4c48-89a1-5ea572231fc3

Response Fields

string

The unique ID of the email

account

string

Account with emailtracking in which the email was sent

channel_name

string

Email-tracking channel name

channel_type

string

Email-tracking channel type

date

datetime

Date of the email. Format: YYYY-MM-DD HH:mm:ss

from_email

integer

Sender's email address

from_name

string

Sender's name

is_spam

boolean

Check if the call is spam

lead

string

Lead created by the parsing feature

string

The unique ID of the lead

call_id

?string

Call from wich the lead was created

created_at

datetime

Creation date of the lead. Format: YYYY-MM-DD HH:mm:ss

email_id

string

Email from wich the lead was created

fields

object

Object paired with key = label and value = value

landing_page

object

Landing Page from wich the lead was created

source

string

Source name from wich the lead come

subject

string

Subject of the email

tracked_email

string

The tracked email address

string[]

Original recipients of the email

Example request:

curl --request GET \
    --get "https://api.magnetis.io/emails/1" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": {
        "id": "etm-4908be34-1489-4806-85f6-11bf12ea13ce",
        "account": {
            "id": "acc-250ce1bd-237d-4e2d-aa17-51293760a801",
            "name": "Artisan Lyon"
        },
        "channel_name": "LeBonCoin",
        "channel_type": "leboncoin",
        "date": "2023-09-25 14:50:12",
        "from_email": "jane.doe@gmail.com",
        "from_name": "Jane Doe",
        "is_spam": false,
        "lead": {
            "id": "lead-9c6187a3-9865-418d-be80-e45d5990f039",
            "call_id": null,
            "created_at": "2023-09-25 14:50:12",
            "email_id": "etm-4908be34-1489-4806-85f6-11bf12ea13ce",
            "fields": {
                "firstname": "Jane",
                "lastname": "Doe",
                "phone": null,
                "email": "jane.doe@gmail.com",
                "zipcode": null
            },
            "landing_page": {
                "title": null,
                "url": null
            },
            "source": "email"
        },
        "subject": "Nouveau message sur votre annonce",
        "tracked_email": "acc.99999.track@mgtmail.fr",
        "to": "entreprise@monemail.com"
    },
    "meta": {
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "account",
            "name": "My account"
        },
        "total": 3
    }
}

Leads

List all leads

GET

https://api.magnetis.io

/leads

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

account_id

Optional. Filter by account ID.

Example:

acc-XXX

limit

Optional. Result per page. 250 if not set.

Example:

250

page

Optional. Pagination page. 1 if not set.

Example:

Response Fields

string

The unique ID of the lead

account

object

Account in which the call was made

call_id

?string

Call from wich the lead was created

created_at

datetime

Creation date of the lead. Format: YYYY-MM-DD HH:mm:ss

email_id

string

Email from wich the lead was created

fields

object

Object paired with key = label and value = value

landing_page

object

Landing Page from wich the lead was created

outgoing

object

Outgoind Call-Tracking informations

source

string

Source name from wich the lead come

Example request:

curl --request GET \
    --get "https://api.magnetis.io/leads" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [
        {
            "id": "lead-8204460e-82fb-4a18-ac0a-fb3f34231372",
            "account": {
                "id": "acc-250ce1bd-237d-4e2d-aa17-51293760a801",
                "name": "Artisan Lyon"
            },
            "call_id": "call-7384f936-b36f-4305-9350-92e3ed67531b",
            "created_at": "2023-09-25 14:50:12",
            "email_id": null,
            "fields": {
                "firstname": "John",
                "lastname": "Doe",
                "phone": "0033647XXXXXX",
                "email": "john.doe@example.com",
                "zipcode": null
            },
            "landing_page": {
                "title": "Ma landing page",
                "url": "https://www.example.com"
            },
            "outgoing": null,
            "source": "call"
        },
        {
            "id": "lead-9c6187a3-9865-418d-be80-e45d5990f039",
            "account": {
                "id": "acc-250ce1bd-237d-4e2d-aa17-51293760a801",
                "name": "Artisan Lyon"
            },
            "call_id": null,
            "created_at": "2023-09-25 14:50:12",
            "email_id": "etm-4908be34-1489-4806-85f6-11bf12ea13ce",
            "fields": {
                "firstname": "Jane",
                "lastname": "Doe",
                "phone": "0033652XXXXXX",
                "email": null,
                "zipcode": null
            },
            "landing_page": {
                "title": null,
                "url": null
            },
            "outgoing": {
                "assignment_date": "2023-09-10 10:00:00",
                "start_date": "2023-09-10 10:00:00",
                "limit_date": "2023-09-10 10:00:00"
            },
            "source": "email"
        }
    ],
    "links": {
        "first": "https://api.magnetis.io/leads?page=1",
        "last": "https://api.magnetis.io/leads?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "path": "https://api.magnetis.io/leads",
        "per_page": 250,
        "to": 2,
        "total": 2,
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "account",
            "name": "My account"
        }
    }
}

Create a lead

POST

https://api.magnetis.io

/leads

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

Body Parameters

account_id

string

required

The id if the account, can be retrieve at /accounts

Example:

acc-6e64b651-026a-46de-ab3e-944a193945a9

fields

object[]

required

Array of field equals to Lead informations

Response Fields

string

The unique ID of the lead

account

object

Account in which the call was made

call_id

?string

Call from wich the lead was created

created_at

datetime

Creation date of the lead. Format: YYYY-MM-DD HH:mm:ss

email_id

string

Email from wich the lead was created

fields

object

Object paired with key = label and value = value

landing_page

object

Landing Page from wich the lead was created

outgoing

object

Outgoind Call-Tracking informations

source

string

Source name from wich the lead come

Example request:

curl --request POST \
    "https://api.magnetis.io/leads" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"account_id\": \"acc-6e64b651-026a-46de-ab3e-944a193945a9\",
    \"fields\": [
        {
            \"label\": \"Prénom\",
            \"value\": \"François\"
        }
    ]
}"

Example response:

{
    "data": {
        "id": "lead-9c6187a3-9865-418d-be80-e45d5990f039",
        "account": {
            "id": "acc-250ce1bd-237d-4e2d-aa17-51293760a801",
            "name": "Artisan Lyon"
        },
        "created_at": "2023-09-25 14:50:12",
        "fields": {
            "firstname": "Jane",
            "lastname": "Doe",
            "phone": "0033652XXXXXX",
            "zipcode": null
        },
        "landing_page": {
            "title": null,
            "url": null
        },
        "outgoing": {
            "assignment_date": "2023-09-10 10:00:00",
            "start_date": "2023-09-10 10:00:00",
            "limit_date": "2023-09-10 10:00:00"
        },
        "source": "api"
    },
    "meta": {
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "account",
            "name": "My account"
        },
        "total": 3
    }
}

Fetch a lead

GET

https://api.magnetis.io

/leads/{slug}

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

slug

string

required

The id of the lead

Example:

lead-6e64b651-026a-46de-ab3e-944a193945a9

Response Fields

string

The unique ID of the lead

account

object

Account in which the call was made

call_id

?string

Call from wich the lead was created

created_at

datetime

Creation date of the lead. Format: YYYY-MM-DD HH:mm:ss

email_id

string

Email from wich the lead was created

fields

object

Object paired with key = label and value = value

landing_page

object

Landing Page from wich the lead was created

outgoing

object

Outgoind Call-Tracking informations

source

string

Source name from wich the lead come

Example request:

curl --request GET \
    --get "https://api.magnetis.io/leads/lead-6e64b651-026a-46de-ab3e-944a193945a9" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": {
        "id": "lead-9c6187a3-9865-418d-be80-e45d5990f039",
        "account": {
            "id": "acc-250ce1bd-237d-4e2d-aa17-51293760a801",
            "name": "Artisan Lyon"
        },
        "created_at": "2023-09-25 14:50:12",
        "fields": {
            "firstname": "Jane",
            "lastname": "Doe",
            "phone": "0033652XXXXXX",
            "zipcode": null
        },
        "landing_page": {
            "title": null,
            "url": null
        },
        "outgoing": {
            "assignment_date": "2023-09-10 10:00:00",
            "start_date": "2023-09-10 10:00:00",
            "limit_date": "2023-09-10 10:00:00"
        },
        "source": "api"
    },
    "meta": {
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "account",
            "name": "My account"
        },
        "total": 3
    }
}

Update a lead

PUT

PATCH

https://api.magnetis.io

/leads/{slug}

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

slug

string

required

The id of the lead

Example:

lead-6e64b651-026a-46de-ab3e-944a193945a9

Body Parameters

fields

object[]

required

Array of field equals to Lead informations

Response Fields

string

The unique ID of the lead

account

object

Account in which the call was made

call_id

?string

Call from wich the lead was created

created_at

datetime

Creation date of the lead. Format: YYYY-MM-DD HH:mm:ss

email_id

string

Email from wich the lead was created

fields

object

Object paired with key = label and value = value

landing_page

object

Landing Page from wich the lead was created

outgoing

object

Outgoind Call-Tracking informations

source

string

Source name from wich the lead come

Example request:

curl --request PUT \
    "https://api.magnetis.io/leads/lead-6e64b651-026a-46de-ab3e-944a193945a9" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"fields\": [
        {
            \"label\": \"Prénom\",
            \"value\": \"François\"
        }
    ]
}"

Example response:

{
    "data": {
        "id": "lead-9c6187a3-9865-418d-be80-e45d5990f039",
        "account": {
            "id": "acc-250ce1bd-237d-4e2d-aa17-51293760a801",
            "name": "Artisan Lyon"
        },
        "created_at": "2023-09-25 14:50:12",
        "fields": {
            "firstname": "Jane",
            "lastname": "Doe",
            "phone": "0033652XXXXXX",
            "zipcode": null
        },
        "landing_page": {
            "title": null,
            "url": null
        },
        "outgoing": {
            "assignment_date": "2023-09-10 10:00:00",
            "start_date": "2023-09-10 10:00:00",
            "limit_date": "2023-09-10 10:00:00"
        },
        "source": "api"
    },
    "meta": {
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "account",
            "name": "My account"
        },
        "total": 3
    }
}

Delete a lead

DELETE

https://api.magnetis.io

/leads/{slug}

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

slug

string

required

The id of the lead

Example:

lead-6e64b651-026a-46de-ab3e-944a193945a9

Response Fields

string

The unique ID of the lead

account

object

Account in which the call was made

call_id

?string

Call from wich the lead was created

created_at

datetime

Creation date of the lead. Format: YYYY-MM-DD HH:mm:ss

email_id

string

Email from wich the lead was created

fields

object

Object paired with key = label and value = value

landing_page

object

Landing Page from wich the lead was created

outgoing

object

Outgoind Call-Tracking informations

source

string

Source name from wich the lead come

Example request:

curl --request DELETE \
    "https://api.magnetis.io/leads/lead-6e64b651-026a-46de-ab3e-944a193945a9" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [],
    "meta": {
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "account",
            "name": "My account"
        },
        "total": 0
    }
}

Monitoring

Daily monitoring

List all daily monitorings

GET

https://api.magnetis.io

/monitorings/daily

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

account_id

Optional. Filter by account ID.

Example:

acc-XXX

limit

Optional. Result per page. 250 if not set.

Example:

250

page

Optional. Pagination page. 1 if not set.

Example:

Response Fields

The unique ID of the monitoring

account

object

Account linked to the alert

created_at

datetime

Monitoring creation date. Format: YYYY-MM-DD HH:mm:ss

enabled

boolean

Active status of the monitoring

last_alert

datetime

Last monitoring alert date. Format: YYYY-MM-DD HH:mm:ss

rate

integer

Lost calls rate before sending an alert

recipients

string[]

Array of emails the alert will be sent to

Example request:

curl --request GET \
    --get "https://api.magnetis.io/monitorings/daily" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [
        {
            "id": "mdl-67bc8021-08f8-44a7-81e0-5002724ed3e7",
            "account": {
                "id": "acc-f27c03a5-9498-4dd1-aeeb-30722b219f2e",
                "name": "Immobilier tertiaire"
            },
            "created_at": "2024-01-02 08:09:53",
            "enabled": true,
            "last_alert": "2024-02-29 13:44:21",
            "rate": "70",
            "recipients": [
                "example@email.fr"
            ]
        }
    ],
    "links": {
        "first": "https://api.magnetis.io/monitorings/daily?page=1",
        "last": "https://api.magnetis.io/monitorings/daily?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "path": "https://api.magnetis.io/monitorings/daily",
        "per_page": 250,
        "to": 1,
        "total": 1,
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "account",
            "name": "My account"
        }
    }
}

Fetch a daily monitoring

GET

https://api.magnetis.io

/monitorings/daily/{account_id}

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

account_id

Account ID

required

Example:

acc-67bc8021-08f8-44a7-81e0-5002724ed3e7

Response Fields

The unique ID of the monitoring

account

object

Account linked to the alert

created_at

datetime

Monitoring creation date. Format: YYYY-MM-DD HH:mm:ss

enabled

boolean

Active status of the monitoring

last_alert

datetime

Last monitoring alert date. Format: YYYY-MM-DD HH:mm:ss

rate

integer

Lost calls rate before sending an alert

recipients

string[]

Array of emails the alert will be sent to

Example request:

curl --request GET \
    --get "https://api.magnetis.io/monitorings/daily/acc-67bc8021-08f8-44a7-81e0-5002724ed3e7" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": {
        "id": "mdl-67bc8021-08f8-44a7-81e0-5002724ed3e7",
        "account": {
            "id": "acc-f27c03a5-9498-4dd1-aeeb-30722b219f2e",
            "name": "Immobilier tertiaire"
        },
        "created_at": "2024-01-02 08:09:53",
        "enabled": true,
        "last_alert": "2024-02-29 13:44:21",
        "rate": "70",
        "recipients": [
            "example@email.fr"
        ]
    },
    "meta": {
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "account",
            "name": "My Account"
        },
        "total": 1
    }
}

Update a daily monitoring

PUT

https://api.magnetis.io

/monitorings/daily/{account_id}

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

account_id

Account ID

required

Example:

acc-67bc8021-08f8-44a7-81e0-5002724ed3e7

Body Parameters

rate

integer

required

Rate before sending an alert.

Example:

recipients

string[]

required

Array of email you want to send the alert.

Example:

["ipsam"]

enabled

boolean

required

Determine if the monitoring is active.

Example:

Response Fields

The unique ID of the monitoring

account

object

Account linked to the alert

created_at

datetime

Monitoring creation date. Format: YYYY-MM-DD HH:mm:ss

enabled

boolean

Active status of the monitoring

last_alert

datetime

Last monitoring alert date. Format: YYYY-MM-DD HH:mm:ss

rate

integer

Lost calls rate before sending an alert

recipients

string[]

Array of emails the alert will be sent to

Example request:

curl --request PUT \
    "https://api.magnetis.io/monitorings/daily/acc-67bc8021-08f8-44a7-81e0-5002724ed3e7" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"rate\": 9,
    \"recipients\": [
        \"ipsam\"
    ],
    \"enabled\": true
}"

Example response:

{
    "data": {
        "id": "mdl-67bc8021-08f8-44a7-81e0-5002724ed3e7",
        "account": {
            "id": "acc-f27c03a5-9498-4dd1-aeeb-30722b219f2e",
            "name": "Immobilier tertiaire"
        },
        "created_at": "2024-01-02 08:09:53",
        "enabled": true,
        "last_alert": "2024-02-29 13:44:21",
        "rate": "70",
        "recipients": [
            "example@email.fr"
        ]
    },
    "meta": {
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "account",
            "name": "My Account"
        },
        "total": 1
    }
}

Recurring monitoring

List all recurring monitorings

GET

https://api.magnetis.io

/monitorings/recurring

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

account_id

Optional. Filter by account ID.

Example:

acc-XXX

limit

Optional. Result per page. 250 if not set.

Example:

250

page

Optional. Pagination page. 1 if not set.

Example:

Response Fields

string

The unique ID of the monitoring

account

object

Account linked to the alert

created_at

datetime

Monitoring creation date. Format: YYYY-MM-DD HH:mm:ss

enabled

boolean

Active status of the monitoring

last_alert

datetime

Last monitoring alert date. Format: YYYY-MM-DD HH:mm:ss

level

integer

Number of lost call before sending an alert

recipients

string[]

Array of emails the alert will be sent to

Example request:

curl --request GET \
    --get "https://api.magnetis.io/monitorings/recurring" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [
        {
            "id": "mrr-6d027ee3-4cff-43a0-84be-1dbc3d7559e5",
            "account": {
                "id": "acc-f27c03a5-9498-4dd1-aeeb-30722b219f2e",
                "name": "Immobilier tertiaire"
            },
            "created_at": "2024-01-02 08:09:53",
            "enabled": true,
            "last_alert": "2024-02-29 13:44:21",
            "level": "10",
            "recipients": [
                "example@email.fr"
            ]
        }
    ],
    "links": {
        "first": "https://api.magnetis.io/monitorings/recurring?page=1",
        "last": "https://api.magnetis.io/monitorings/recurring?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "path": "https://api.magnetis.io/monitorings/recurring",
        "per_page": 250,
        "to": 1,
        "total": 1,
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "account",
            "name": "My account"
        }
    }
}

Fetch a recurring monitoring

GET

https://api.magnetis.io

/monitorings/recurring/{account_id}

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

account_id

Account ID

required

Example:

acc-6d027ee3-4cff-43a0-84be-1dbc3d7559e5

Response Fields

string

The unique ID of the monitoring

account

object

Account linked to the alert

created_at

datetime

Monitoring creation date. Format: YYYY-MM-DD HH:mm:ss

enabled

boolean

Active status of the monitoring

last_alert

datetime

Last monitoring alert date. Format: YYYY-MM-DD HH:mm:ss

level

integer

Number of lost call before sending an alert

recipients

string[]

Array of emails the alert will be sent to

Example request:

curl --request GET \
    --get "https://api.magnetis.io/monitorings/recurring/acc-6d027ee3-4cff-43a0-84be-1dbc3d7559e5" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": {
        "id": "mrr-6d027ee3-4cff-43a0-84be-1dbc3d7559e5",
        "account": {
            "id": "acc-f27c03a5-9498-4dd1-aeeb-30722b219f2e",
            "name": "Immobilier tertiaire"
        },
        "created_at": "2024-01-02 08:09:53",
        "enabled": true,
        "last_alert": "2024-02-29 13:44:21",
        "level": "10",
        "recipients": [
            "example@email.fr"
        ]
    },
    "meta": {
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "account",
            "name": "My Account"
        },
        "total": 1
    }
}

Update a recurring monitoring

PUT

https://api.magnetis.io

/monitorings/recurring/{account_id}

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

account_id

Account ID

required

Example:

acc-6d027ee3-4cff-43a0-84be-1dbc3d7559e5

Body Parameters

level

integer

required

Number of lost call before sending an alert.

Example:

recipients

string

required

Example:

laborum

enabled

boolean

required

Determine if the monitoring is active.

Example:

mailees

string[]

required

Array of email you want to send the alert.

Example:

["molestiae"]

Response Fields

string

The unique ID of the monitoring

account

object

Account linked to the alert

created_at

datetime

Monitoring creation date. Format: YYYY-MM-DD HH:mm:ss

enabled

boolean

Active status of the monitoring

last_alert

datetime

Last monitoring alert date. Format: YYYY-MM-DD HH:mm:ss

level

integer

Number of lost call before sending an alert

recipients

string[]

Array of emails the alert will be sent to

Example request:

curl --request PUT \
    "https://api.magnetis.io/monitorings/recurring/acc-6d027ee3-4cff-43a0-84be-1dbc3d7559e5" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"level\": 11,
    \"recipients\": \"laborum\",
    \"enabled\": true,
    \"mailees\": [
        \"molestiae\"
    ]
}"

Example response:

{
    "data": {
        "id": "mrr-6d027ee3-4cff-43a0-84be-1dbc3d7559e5",
        "account": {
            "id": "acc-f27c03a5-9498-4dd1-aeeb-30722b219f2e",
            "name": "Immobilier tertiaire"
        },
        "created_at": "2024-01-02 08:09:53",
        "enabled": true,
        "last_alert": "2024-02-29 13:44:21",
        "level": "10",
        "recipients": [
            "example@email.fr"
        ]
    },
    "meta": {
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "account",
            "name": "My Account"
        },
        "total": 1
    }
}

Recipient monitoring

Fetch the recipient monitoring

GET

https://api.magnetis.io

/monitorings/recipient

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

Response Fields

The unique ID of the moniroting

organization_id

string

Organization linked to the monitoring

created_at

datetime

Monitoring creation date. Format: YYYY-MM-DD HH:mm:ss

enabled

boolean

Active status of the monitoring

last_alert

datetime

Last monitoring alert date. Format: YYYY-MM-DD HH:mm:ss

level

integer

Number of lost call before sending an alert

recipients

string[]

Array of emails the alert will be sent to

Example request:

curl --request GET \
    --get "https://api.magnetis.io/monitorings/recipient" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": {
        "id": "mrp-2e25425a-26b2-455e-a51b-0693af0f3081",
        "organization_id": "org-6d0aff3d-3141-45bb-8b2b-2d6e2d8dc18e",
        "created_at": "2024-01-02 08:09:53",
        "enabled": false,
        "last_alert": "2024-02-29 13:44:21",
        "level": "5",
        "recipients": [
            "example@email.fr"
        ]
    },
    "meta": {
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "account",
            "name": "My Account"
        },
        "total": 1
    }
}

Update the recipient monitoring

PUT

https://api.magnetis.io

/monitorings/recipient

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

Body Parameters

level

integer

required

Number of lost call before sending an alert.

Example:

recipients

string[]

required

Array of email you want to send the alert.

Example:

["culpa"]

enabled

boolean

required

Determine if the monitoring is active.

Example:

Response Fields

The unique ID of the moniroting

organization_id

string

Organization linked to the monitoring

created_at

datetime

Monitoring creation date. Format: YYYY-MM-DD HH:mm:ss

enabled

boolean

Active status of the monitoring

last_alert

datetime

Last monitoring alert date. Format: YYYY-MM-DD HH:mm:ss

level

integer

Number of lost call before sending an alert

recipients

string[]

Array of emails the alert will be sent to

Example request:

curl --request PUT \
    "https://api.magnetis.io/monitorings/recipient" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"level\": 2,
    \"recipients\": [
        \"culpa\"
    ],
    \"enabled\": true
}"

Example response:

{
    "data": {
        "id": "mrp-2e25425a-26b2-455e-a51b-0693af0f3081",
        "organization_id": "org-6d0aff3d-3141-45bb-8b2b-2d6e2d8dc18e",
        "created_at": "2024-01-02 08:09:53",
        "enabled": false,
        "last_alert": "2024-02-29 13:44:21",
        "level": "5",
        "recipients": [
            "example@email.fr"
        ]
    },
    "meta": {
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "account",
            "name": "My Account"
        },
        "total": 1
    }
}

Numbers

List all tracked numbers

GET

https://api.magnetis.io

/numbers

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

account_id

Optional. Filter by account ID.

Example:

acc-XXX

limit

Optional. Result per page. 250 if not set.

Example:

250

page

Optional. Pagination page. 1 if not set.

Example:

Response Fields

string

The unique ID of the tracked number

account

object

Account containing the tracked number

channel_name

string

Tracking channel name

channel_type

string

country

string

Country of the tracked number. Enum: FRA, ESP, DEU, ITA, BEL

created_at

datetime

Number creation datetime. Format: YYYY-MM-DD HH:mm:ss

functionalities

object

Number functionalities

recording

object|null

Recording functionalities

whisper

object|null

Whisper functionalities

is_premium

string

Check if the number is a mnemonic number

number

string

Tracked number.

recipient

object

Recipient of calls made to this number

string

The unique ID of the recipient

country

string

Country of the recipient number. Enum: FRA, ESP, DEU, ITA, BEL

created_at

datetime

Recipient creation datetime. Format: YYYY-MM-DD HH:mm:ss

name

string

Recipient name

number

string

Recipient number

type

string

Type of the recipient number. Enum: mobile, geographic, national, special

type

string

Type of the tracked number. Enum: mobile, geographic, national, special

Example request:

curl --request GET \
    --get "https://api.magnetis.io/numbers" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [
        {
            "id": "num-a81cf765-0e48-4797-b315-f702c783996e",
            "account": {
                "id": "acc-f702dcb6-87cf-4bc4-8632-560c43aec1a4",
                "name": "Auto Bordeaux"
            },
            "channel_name": "Google Ads",
            "channel_type": "googleads",
            "country": "FRA",
            "created_at": "2023-07-14 13:52:27",
            "functionalities": {
                "recording": {
                    "deactivation": 1,
                    "terms": "custom",
                    "terms_audio": "sda-e66b21e0-2064-4175-8fa2-2f7a60e64da4"
                },
                "whisper": {
                    "audio": "sda-ef617d12-528a-40fe-a997-da4cda4e4ba7"
                }
            },
            "is_premium": false,
            "number": "0033522334455",
            "recipient": {
                "id": "rcp-3921328c-5966-4df9-a9a9-5f2a8f383e3a",
                "country": "FRA",
                "created_at": "2023-07-14 13:47:21",
                "name": "Concession Bordeaux",
                "number": "0033698765432",
                "type": "mobile"
            },
            "type": "geographic"
        },
        {
            "id": "num-cdea62a0-05f3-4183-b285-697458cadb9e",
            "account": {
                "id": "acc-f702dcb6-87cf-4bc4-8632-560c43aec1a4",
                "name": "Auto Bordeaux"
            },
            "channel_name": "SEO",
            "channel_type": "seo",
            "country": "FRA",
            "created_at": "2023-07-14 13:52:27",
            "functionalities": {
                "recording": null,
                "whisper": null
            },
            "is_premium": false,
            "number": "0033555443322",
            "recipient": {
                "id": "rcp-3921328c-5966-4df9-a9a9-5f2a8f383e3a",
                "country": "FRA",
                "created_at": "2023-07-14 13:47:21",
                "name": "Concession Bordeaux",
                "number": "0033698765432",
                "type": "mobile"
            },
            "type": "geographic"
        },
        {
            "id": "num-e6075fb2-172a-4acf-bc49-6076bbb0c44f",
            "account": {
                "id": "acc-f27c03a5-9498-4dd1-aeeb-30722b219f2e",
                "name": "Immo Paris"
            },
            "channel_name": "Site Internet",
            "channel_type": "website",
            "country": "FRA",
            "created_at": "2023-07-21 13:58:30",
            "functionalities": {
                "recording": null,
                "whisper": null
            },
            "is_premium": false,
            "number": "0033199887766",
            "recipient": {
                "id": "rcp-b7958038-063d-4c75-b7ec-3baea00c8444",
                "country": "FRA",
                "created_at": "2023-07-21 12:54:07",
                "name": "Agence Paris",
                "number": "0033166778899",
                "type": "geographic"
            },
            "type": "geographic"
        }
    ],
    "links": {
        "first": "https://api.magnetis.io/numbers?page=1",
        "last": "https://api.magnetis.io/numbers?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "path": "https://api.magnetis.io/numbers",
        "per_page": 250,
        "to": 3,
        "total": 3,
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "account",
            "name": "My account"
        }
    }
}

Create a tracked number

POST

https://api.magnetis.io

/numbers

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

Body Parameters

account_id

string

required

The account ID in which to put the tracked number

Example:

acc-XXX

area_code

string

required

The area code of the number

Example:

00339

channel_name

string

required

The channel name of the number

Example:

My website

channel_type

string

required

The channel type of the number. Enum: googleads, googleadsextension, bingads, sea, google, bing, seo, website, googlemybusiness, externalwebsite, landingpage, emailing, referrer, direct, sms, application, banner, vms, storelocator, linkedin, facebook, twitter, instagram, social, flyer, poster, businesscard, print, press, billboard, magazine, pagesjaunes, leboncoin, logicimmo, seloger, bienici, paruvendu, ouestfrance, explorimo, meilleursagents, avendrealouer, fnaim, lacentrale, largus, event, lead, other

Example:

website

country

string

required

The country of the number. Enum: FRA, ESP, DEU, ITA, BEL

Example:

FRA

recipient_id

string|null

required

The recipient ID to whom the tracked number should be redirected

Example:

rec-XXX

recording

object|null

required

Recording functionalities

Response Fields

string

The unique ID of the tracked number

account

object

Account containing the tracked number

channel_name

string

Tracking channel name

channel_type

string

country

string

Country of the tracked number. Enum: FRA, ESP, DEU, ITA, BEL

created_at

datetime

Number creation datetime. Format: YYYY-MM-DD HH:mm:ss

functionalities

object

Number functionalities

recording

object|null

Recording functionalities

whisper

object|null

Whisper functionalities

is_premium

string

Check if the number is a mnemonic number

number

string

Tracked number.

recipient

object

Recipient of calls made to this number

string

The unique ID of the recipient

country

string

Country of the recipient number. Enum: FRA, ESP, DEU, ITA, BEL

created_at

datetime

Recipient creation datetime. Format: YYYY-MM-DD HH:mm:ss

name

string

Recipient name

number

string

Recipient number

type

string

Type of the recipient number. Enum: mobile, geographic, national, special

type

string

Type of the tracked number. Enum: mobile, geographic, national, special

Example request:

curl --request POST \
    "https://api.magnetis.io/numbers" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"account_id\": \"acc-XXX\",
    \"area_code\": \"00339\",
    \"channel_name\": \"My website\",
    \"channel_type\": \"website\",
    \"country\": \"FRA\",
    \"recipient_id\": \"rec-XXX\",
    \"recording\": \"dicta\"
}"

Example response:

{
    "data": {
        "id": "num-a81cf765-0e48-4797-b315-f702c783996e",
        "account": {
            "id": "acc-f702dcb6-87cf-4bc4-8632-560c43aec1a4",
            "name": "Auto Bordeaux"
        },
        "channel_name": "Google Ads",
        "channel_type": "googleads",
        "country": "FRA",
        "created_at": "2023-07-14 13:52:27",
        "functionalities": {
            "recording": {
                "deactivation": 1,
                "terms": "custom",
                "terms_audio": "sda-e66b21e0-2064-4175-8fa2-2f7a60e64da4"
            },
            "whisper": {
                "audio": "sda-ef617d12-528a-40fe-a997-da4cda4e4ba7"
            }
        },
        "is_premium": false,
        "number": "0033522334455",
        "recipient": {
            "id": "rcp-3921328c-5966-4df9-a9a9-5f2a8f383e3a",
            "country": "FRA",
            "created_at": "2023-07-14 13:47:21",
            "name": "Concession Bordeaux",
            "number": "0033698765432",
            "type": "mobile"
        },
        "type": "geographic"
    },
    "meta": {
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "account",
            "name": "My account"
        },
        "total": 1
    }
}

Fetch a tracked number

GET

https://api.magnetis.io

/numbers/{id}

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

string

required

Required. The ID of the call.

Example:

num-50700e9e-879e-480a-859a-1db8301bd712

Response Fields

string

The unique ID of the tracked number

account

object

Account containing the tracked number

channel_name

string

Tracking channel name

channel_type

string

country

string

Country of the tracked number. Enum: FRA, ESP, DEU, ITA, BEL

created_at

datetime

Number creation datetime. Format: YYYY-MM-DD HH:mm:ss

functionalities

object

Number functionalities

recording

object|null

Recording functionalities

whisper

object|null

Whisper functionalities

is_premium

string

Check if the number is a mnemonic number

number

string

Tracked number.

recipient

object

Recipient of calls made to this number

string

The unique ID of the recipient

country

string

Country of the recipient number. Enum: FRA, ESP, DEU, ITA, BEL

created_at

datetime

Recipient creation datetime. Format: YYYY-MM-DD HH:mm:ss

name

string

Recipient name

number

string

Recipient number

type

string

Type of the recipient number. Enum: mobile, geographic, national, special

type

string

Type of the tracked number. Enum: mobile, geographic, national, special

Example request:

curl --request GET \
    --get "https://api.magnetis.io/numbers/num-50700e9e-879e-480a-859a-1db8301bd712" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": {
        "id": "num-a81cf765-0e48-4797-b315-f702c783996e",
        "account": {
            "id": "acc-f702dcb6-87cf-4bc4-8632-560c43aec1a4",
            "name": "Auto Bordeaux"
        },
        "channel_name": "Google Ads",
        "channel_type": "googleads",
        "country": "FRA",
        "created_at": "2023-07-14 13:52:27",
        "functionalities": {
            "recording": {
                "deactivation": 1,
                "terms": "custom",
                "terms_audio": "sda-e66b21e0-2064-4175-8fa2-2f7a60e64da4"
            },
            "whisper": {
                "audio": "sda-ef617d12-528a-40fe-a997-da4cda4e4ba7"
            }
        },
        "is_premium": false,
        "number": "0033522334455",
        "recipient": {
            "id": "rcp-3921328c-5966-4df9-a9a9-5f2a8f383e3a",
            "country": "FRA",
            "created_at": "2023-07-14 13:47:21",
            "name": "Concession Bordeaux",
            "number": "0033698765432",
            "type": "mobile"
        },
        "type": "geographic"
    },
    "meta": {
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "account",
            "name": "My account"
        },
        "total": 1
    }
}

Update a tracked number

PUT

PATCH

https://api.magnetis.io

/numbers/{slug}

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

string

required

The id of the number.

Example:

num-50700e9e-879e-480a-859a-1db8301bd712

Body Parameters

channel_name

string

The channel name of the number

Example:

My website

channel_type

string

Example:

website

recipient_id

string

The recipient ID to whom the tracked number should be redirected

Example:

rec-XXX

recording

object|null

required

Recording functionalities. Do not put this field to keep actual parameters. Set to null to disable recording

Response Fields

string

The unique ID of the tracked number

account

object

Account containing the tracked number

channel_name

string

Tracking channel name

channel_type

string

country

string

Country of the tracked number. Enum: FRA, ESP, DEU, ITA, BEL

created_at

datetime

Number creation datetime. Format: YYYY-MM-DD HH:mm:ss

functionalities

object

Number functionalities

recording

object|null

Recording functionalities

whisper

object|null

Whisper functionalities

is_premium

string

Check if the number is a mnemonic number

number

string

Tracked number.

recipient

object

Recipient of calls made to this number

string

The unique ID of the recipient

country

string

Country of the recipient number. Enum: FRA, ESP, DEU, ITA, BEL

created_at

datetime

Recipient creation datetime. Format: YYYY-MM-DD HH:mm:ss

name

string

Recipient name

number

string

Recipient number

type

string

Type of the recipient number. Enum: mobile, geographic, national, special

type

string

Type of the tracked number. Enum: mobile, geographic, national, special

Example request:

curl --request PUT \
    "https://api.magnetis.io/numbers/1" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"channel_name\": \"My website\",
    \"channel_type\": \"website\",
    \"recipient_id\": \"rec-XXX\",
    \"recording\": \"voluptate\"
}"

Example response:

{
    "data": {
        "id": "num-a81cf765-0e48-4797-b315-f702c783996e",
        "account": {
            "id": "acc-f702dcb6-87cf-4bc4-8632-560c43aec1a4",
            "name": "Auto Bordeaux"
        },
        "channel_name": "Google Ads",
        "channel_type": "googleads",
        "country": "FRA",
        "created_at": "2023-07-14 13:52:27",
        "functionalities": {
            "recording": {
                "deactivation": 1,
                "terms": "custom",
                "terms_audio": "sda-e66b21e0-2064-4175-8fa2-2f7a60e64da4"
            },
            "whisper": {
                "audio": "sda-ef617d12-528a-40fe-a997-da4cda4e4ba7"
            }
        },
        "is_premium": false,
        "number": "0033522334455",
        "recipient": {
            "id": "rcp-3921328c-5966-4df9-a9a9-5f2a8f383e3a",
            "country": "FRA",
            "created_at": "2023-07-14 13:47:21",
            "name": "Concession Bordeaux",
            "number": "0033698765432",
            "type": "mobile"
        },
        "type": "geographic"
    },
    "meta": {
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "account",
            "name": "My account"
        },
        "total": 1
    }
}

Delete a tracked number

DELETE

https://api.magnetis.io

/numbers/{slug}

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

slug

string

required

The id of the number.

Example:

num-50700e9e-879e-480a-859a-1db8301bd712

Response Fields

string

The unique ID of the tracked number

account

object

Account containing the tracked number

channel_name

string

Tracking channel name

channel_type

string

country

string

Country of the tracked number. Enum: FRA, ESP, DEU, ITA, BEL

created_at

datetime

Number creation datetime. Format: YYYY-MM-DD HH:mm:ss

functionalities

object

Number functionalities

recording

object|null

Recording functionalities

whisper

object|null

Whisper functionalities

is_premium

string

Check if the number is a mnemonic number

number

string

Tracked number.

recipient

object

Recipient of calls made to this number

string

The unique ID of the recipient

country

string

Country of the recipient number. Enum: FRA, ESP, DEU, ITA, BEL

created_at

datetime

Recipient creation datetime. Format: YYYY-MM-DD HH:mm:ss

name

string

Recipient name

number

string

Recipient number

type

string

Type of the recipient number. Enum: mobile, geographic, national, special

type

string

Type of the tracked number. Enum: mobile, geographic, national, special

Example request:

curl --request DELETE \
    "https://api.magnetis.io/numbers/num-50700e9e-879e-480a-859a-1db8301bd712" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": {
        "id": "num-a81cf765-0e48-4797-b315-f702c783996e",
        "account": {
            "id": "acc-f702dcb6-87cf-4bc4-8632-560c43aec1a4",
            "name": "Auto Bordeaux"
        },
        "channel_name": "Google Ads",
        "channel_type": "googleads",
        "country": "FRA",
        "created_at": "2023-07-14 13:52:27",
        "functionalities": {
            "recording": {
                "deactivation": 1,
                "terms": "custom",
                "terms_audio": "sda-e66b21e0-2064-4175-8fa2-2f7a60e64da4"
            },
            "whisper": {
                "audio": "sda-ef617d12-528a-40fe-a997-da4cda4e4ba7"
            }
        },
        "is_premium": false,
        "number": "0033522334455",
        "recipient": {
            "id": "rcp-3921328c-5966-4df9-a9a9-5f2a8f383e3a",
            "country": "FRA",
            "created_at": "2023-07-14 13:47:21",
            "name": "Concession Bordeaux",
            "number": "0033698765432",
            "type": "mobile"
        },
        "type": "geographic"
    },
    "meta": {
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "account",
            "name": "My account"
        },
        "total": 1
    }
}

Recipients

List all recipients

GET

https://api.magnetis.io

/recipients

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

account_id

Optional. Filter by account ID.

Example:

acc-XXX

limit

Optional. Result per page. 250 if not set.

Example:

250

page

Optional. Pagination page. 1 if not set.

Example:

Response Fields

string

The unique ID of the recipient

account

object

Account containing the recipient

country

string

Country of the recipient number. Enum: FRA, ESP, DEU, ITA, BEL

created_at

datetime

Recipient creation datetime. Format: YYYY-MM-DD HH:mm:ss

name

string

Recipient name

number

string

Recipient number

type

string

Type of the recipient number. Enum: mobile, geographic, national, special

Example request:

curl --request GET \
    --get "https://api.magnetis.io/recipients" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

Headers

                                                            cache-control
                                                            : no-cache, private
                                                                                                                    content-type
                                                            : application/json
                                                                                                                    x-ratelimit-limit
                                                            : 600
                                                                                                                    x-ratelimit-remaining
                                                            : 598

{
    "error": "Api key is invalid",
    "data": []
}

Create a recipient

POST

https://api.magnetis.io

/recipients

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

Body Parameters

account_id

string

required

The id of the account you want to link this new recipient

Example:

acc-6e64b651-026a-46de-ab3e-944a193945a9

country

string

required

The country this new recipient

Example:

FRA

name

string

required

The name of the new recipient

Example:

Bruno

number

string

required

The number of this new recipient in international format

Example:

003362345XXXX

type

string

required

The phone type of this new recipient.
Can be: geographic, national, mobile

Example:

geographic

Response Fields

string

The unique ID of the recipient

account

object

Account containing the recipient

country

string

Country of the recipient number. Enum: FRA, ESP, DEU, ITA, BEL

created_at

datetime

Recipient creation datetime. Format: YYYY-MM-DD HH:mm:ss

name

string

Recipient name

number

string

Recipient number

type

string

Type of the recipient number. Enum: mobile, geographic, national, special

Example request:

curl --request POST \
    "https://api.magnetis.io/recipients" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"account_id\": \"acc-6e64b651-026a-46de-ab3e-944a193945a9\",
    \"country\": \"FRA\",
    \"name\": \"Bruno\",
    \"number\": \"003362345XXXX\",
    \"type\": \"geographic\"
}"

Example response:

Headers

                                                            cache-control
                                                            : no-cache, private
                                                                                                                    content-type
                                                            : application/json
                                                                                                                    x-ratelimit-limit
                                                            : 600
                                                                                                                    x-ratelimit-remaining
                                                            : 597

{
    "error": "Api key is invalid",
    "data": []
}

Fetch a recipient

GET

https://api.magnetis.io

/recipients/{slug}

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

slug

string

required

The id of the recipient.

Example:

rcp-85ea860d-74ce-4ac9-90fd-b85030eb34c0

Response Fields

string

The unique ID of the recipient

account

object

Account containing the recipient

country

string

Country of the recipient number. Enum: FRA, ESP, DEU, ITA, BEL

created_at

datetime

Recipient creation datetime. Format: YYYY-MM-DD HH:mm:ss

name

string

Recipient name

number

string

Recipient number

type

string

Type of the recipient number. Enum: mobile, geographic, national, special

Example request:

curl --request GET \
    --get "https://api.magnetis.io/recipients/rcp-85ea860d-74ce-4ac9-90fd-b85030eb34c0" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

Headers

                                                            cache-control
                                                            : no-cache, private
                                                                                                                    content-type
                                                            : application/json
                                                                                                                    x-ratelimit-limit
                                                            : 600
                                                                                                                    x-ratelimit-remaining
                                                            : 596

{
    "error": "Api key is invalid",
    "data": []
}

Update a recipient

PUT

PATCH

https://api.magnetis.io

/recipients/{slug}

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

slug

string

required

The id of the recipient.

Example:

rcp-85ea860d-74ce-4ac9-90fd-b85030eb34c0

Body Parameters

name

string

The name of the new recipient

Example:

Bruno

Response Fields

string

The unique ID of the recipient

account

object

Account containing the recipient

country

string

Country of the recipient number. Enum: FRA, ESP, DEU, ITA, BEL

created_at

datetime

Recipient creation datetime. Format: YYYY-MM-DD HH:mm:ss

name

string

Recipient name

number

string

Recipient number

type

string

Type of the recipient number. Enum: mobile, geographic, national, special

Example request:

curl --request PUT \
    "https://api.magnetis.io/recipients/rcp-85ea860d-74ce-4ac9-90fd-b85030eb34c0" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"name\": \"Bruno\"
}"

Example response:

Headers

                                                            cache-control
                                                            : no-cache, private
                                                                                                                    content-type
                                                            : application/json
                                                                                                                    x-ratelimit-limit
                                                            : 600
                                                                                                                    x-ratelimit-remaining
                                                            : 595

{
    "error": "Api key is invalid",
    "data": []
}

Delete a recipient

DELETE

https://api.magnetis.io

/recipients/{slug}

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

slug

string

required

The id of the recipient.

Example:

rcp-85ea860d-74ce-4ac9-90fd-b85030eb34c0

Response Fields

string

The unique ID of the recipient

account

object

Account containing the recipient

country

string

Country of the recipient number. Enum: FRA, ESP, DEU, ITA, BEL

created_at

datetime

Recipient creation datetime. Format: YYYY-MM-DD HH:mm:ss

name

string

Recipient name

number

string

Recipient number

type

string

Type of the recipient number. Enum: mobile, geographic, national, special

Example request:

curl --request DELETE \
    "https://api.magnetis.io/recipients/rcp-85ea860d-74ce-4ac9-90fd-b85030eb34c0" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

Headers

                                                            cache-control
                                                            : no-cache, private
                                                                                                                    content-type
                                                            : application/json
                                                                                                                    x-ratelimit-limit
                                                            : 600
                                                                                                                    x-ratelimit-remaining
                                                            : 594

{
    "error": "Api key is invalid",
    "data": []
}

Reports

List all reports

GET

https://api.magnetis.io

/reports

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

account_id

Optional. Filter by account ID.

Example:

acc-XXX

limit

Optional. Result per page. 250 if not set.

Example:

250

page

Optional. Pagination page. 1 if not set.

Example:

Response Fields

string

ID of the report

accounts

string[]

Array of accounts linked to the report (only with network api key)

account

object

Account linked to the report (only with account api key)

all

boolean

Define if the report need to be send to every user in the account or only for choosen emails

created_at

datetime

Report creation date. Format: YYYY-MM-DD HH:mm:ss

period

string

Define period use to generate the report. Enum: daily,weekly,monthly

day_week

integer

Define the day on which the report must be send. Sunday is equal to 0. Only for weekly period

day_month

integer

Define the day on which the report must be send. The last day of the month is equal to 28. Only for monthly period

enabled

boolean

Active status of the report

private

boolean

Define if the report can be only view by the creator or everyone in the account. Only for reports created in our interface.

network

object

Network linked to this report, used in combination with the accounts field

recipients

string[]

Array of email the report will be sent to

sender

string

The left part of the sender email adress before @

subject

string

Email subject

title

string

Report title

type

string

Report type. Enum: synthesis, comparative, lostcall, extract

user

object

If created from our interface, the user who created the report is linked here

Example request:

curl --request GET \
    --get "https://api.magnetis.io/reports" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [
        {
            "id": "rep-7a3501db-5bc4-4161-aba3-d51f3acc288b",
            "accounts": [],
            "account": {
                "id": "acc-f27c03a5-9498-4dd1-aeeb-30722b219f2e",
                "name": "Immobilier tertiaire"
            },
            "all": 0,
            "created_at": "2024-03-04 09:06:09",
            "period": "weekly",
            "day_week": 2,
            "day_month": null,
            "private": 0,
            "network": null,
            "recipients": [
                {
                    "email": "example@email.fr",
                    "type": "to"
                }
            ],
            "sender": "contact@email.fr",
            "subject": "",
            "title": "Rapport d'extraction des appels manqués",
            "type": "lostcall",
            "user": {
                "id": "usr-0ca9023b-b57b-4a5b-867b-e6858287575f",
                "created_at": "2024-03-04T08:06:08.000000Z",
                "email": "example@email.fr",
                "firstname": "John",
                "lang": "fr",
                "lastname": "Doe",
                "phone": "03 62 XX XX XX"
            }
        },
        {
            "id": "rep-4f6dccfb-33cd-43ce-b94e-ff92e791aab3",
            "accounts": [],
            "account": {
                "id": "acc-f27c03a5-9498-4dd1-aeeb-30722b219f2e",
                "name": "Immobilier tertiaire"
            },
            "all": 0,
            "created_at": "2024-03-04 09:06:09",
            "period": "daily",
            "day_week": null,
            "day_month": null,
            "private": 0,
            "network": null,
            "recipients": [
                {
                    "email": "example@email.fr",
                    "type": "to"
                }
            ],
            "sender": "contact@email.fr",
            "subject": "",
            "title": "Rapport de synthèse",
            "type": "synthesis",
            "user": {
                "id": "usr-0ca9023b-b57b-4a5b-867b-e6858287575f",
                "created_at": "2024-03-04T08:06:08.000000Z",
                "email": "example@email.fr",
                "firstname": "John",
                "lang": "fr",
                "lastname": "Doe",
                "phone": "03 62 XX XX XX"
            }
        },
        {
            "id": "rep-ea6476f6-f777-4e3c-923f-712d676f1168",
            "accounts": [],
            "account": {
                "id": "acc-f27c03a5-9498-4dd1-aeeb-30722b219f2e",
                "name": "Immobilier tertiaire"
            },
            "all": 1,
            "created_at": "2024-03-04 09:06:09",
            "period": "monthly",
            "day_week": null,
            "day_month": 8,
            "private": 0,
            "network": null,
            "recipients": [],
            "sender": "contact@email.fr",
            "subject": "",
            "title": "Rapport de synthèse web",
            "type": "web",
            "user": {
                "id": "usr-0ca9023b-b57b-4a5b-867b-e6858287575f",
                "created_at": "2024-03-04T08:06:08.000000Z",
                "email": "example@email.fr",
                "firstname": "John",
                "lang": "fr",
                "lastname": "Doe",
                "phone": "03 62 XX XX XX"
            }
        },
        {
            "id": "rep-5345fd1a-7331-4242-ab5c-71de77e33818",
            "accounts": [],
            "account": {
                "id": "acc-f27c03a5-9498-4dd1-aeeb-30722b219f2e",
                "name": "Immobilier tertiaire"
            },
            "all": false,
            "created_at": "2024-03-04 09:06:09",
            "period": "monthly",
            "day_week": null,
            "day_month": 12,
            "private": 1,
            "network": null,
            "recipients": [
                {
                    "email": "example@email.fr",
                    "type": "to"
                }
            ],
            "sender": "contact@email.fr",
            "subject": "",
            "title": "Rapport d'extraction des appels",
            "type": "extract",
            "user": {
                "id": "usr-0ca9023b-b57b-4a5b-867b-e6858287575f",
                "created_at": "2024-03-04T08:06:08.000000Z",
                "email": "example@email.fr",
                "firstname": "John",
                "lang": "fr",
                "lastname": "Doe",
                "phone": "03 62 XX XX XX"
            }
        }
    ],
    "links": {
        "first": "https://api.magnetis.io/reports?page=1",
        "last": "https://api.magnetis.io/reports?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "path": "https://api.magnetis.io/reports",
        "per_page": 250,
        "to": 4,
        "total": 4,
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "account",
            "name": "My account"
        }
    }
}

Create a report

POST

https://api.magnetis.io

/reports

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

Body Parameters

account_id

string

The ID of the account linked to the report, from which the statistics will come.
Cannot be used with a network_id and accounts

Example:

acc-6e64b651-026a-46de-ab3e-944a193945a9

network_id

string

The ID of the network linked to the report when multiple accounts are used to generate the statistics

Example:

net-6e64b651-026a-46de-ab3e-944a193945a9

accounts

string[]

List of account IDs used to generate report statistics if it is linked to a network

Example:

[acc-6e64b651-026a-46de-ab3e-944a193945a9, acc-cf162a0f-8ea4-4aad-999c-81f8e85cb033]

sender

string

required

Sender of the report, in lowercase (left part of the email, before @)

Example:

contact

all

boolean

Need to be true if you want to send the report to all user who have access to it and with no additional recipients

recipients

object[]

Array of email you want to send the report, required when all is not set or false.

subject

string

required

Subject of the email

Example:

Call-tracking report

title

string

required

Title of the report.
Used to recognize report.

Example:

My statistic report

type

string

required

Report type. Enum: synthesis, comparative, lostcall, extract

Example:

synthesis

period

string

required

Define period use to generate the report. Enum: daily, weekly, monthly

Example:

weekly

day_week

integer

Must be between 0 and 6.
0: Sunday
6: Saturday

Example:

day_month

integer

Must be between 1 and 28.
1: the first day of the month
28: the last day of the month

Example:

null

enabled

boolean

required

Determines if the report is active

Response Fields

string

ID of the report

accounts

string[]

Array of accounts linked to the report (only with network api key)

account

object

Account linked to the report (only with account api key)

all

boolean

Define if the report need to be send to every user in the account or only for choosen emails

created_at

datetime

Report creation date. Format: YYYY-MM-DD HH:mm:ss

period

string

Define period use to generate the report. Enum: daily,weekly,monthly

day_week

integer

Define the day on which the report must be send. Sunday is equal to 0. Only for weekly period

day_month

integer

Define the day on which the report must be send. The last day of the month is equal to 28. Only for monthly period

enabled

boolean

Active status of the report

private

boolean

Define if the report can be only view by the creator or everyone in the account. Only for reports created in our interface.

network

object

Network linked to this report, used in combination with the accounts field

recipients

string[]

Array of email the report will be sent to

sender

string

The left part of the sender email adress before @

subject

string

Email subject

title

string

Report title

type

string

Report type. Enum: synthesis, comparative, lostcall, extract

user

object

If created from our interface, the user who created the report is linked here

Example request:

curl --request POST \
    "https://api.magnetis.io/reports" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"account_id\": \"acc-6e64b651-026a-46de-ab3e-944a193945a9\",
    \"network_id\": \"net-6e64b651-026a-46de-ab3e-944a193945a9\",
    \"accounts\": \"[acc-6e64b651-026a-46de-ab3e-944a193945a9, acc-cf162a0f-8ea4-4aad-999c-81f8e85cb033]\",
    \"sender\": \"contact\",
    \"all\": false,
    \"recipients\": [
        {
            \"email\": \"email@test.fr\",
            \"type\": \"to\"
        }
    ],
    \"subject\": \"Call-tracking report\",
    \"title\": \"My statistic report\",
    \"type\": \"synthesis\",
    \"period\": \"weekly\",
    \"day_week\": \"1\",
    \"day_month\": \"null\",
    \"enabled\": false
}"

Example response:

{
    "data": {
        "id": "rep-5345fd1a-7331-4242-ab5c-71de77e33818",
        "accounts": [],
        "account": {
            "id": "acc-f27c03a5-9498-4dd1-aeeb-30722b219f2e",
            "name": "Immobilier tertiaire"
        },
        "all": false,
        "created_at": "2024-03-04 09:06:09",
        "period": "monthly",
        "day_week": null,
        "day_month": 12,
        "private": 1,
        "network": null,
        "recipients": [
            {
                "email": "example@email.fr",
                "type": "to"
            }
        ],
        "sender": "contact@email.fr",
        "subject": "",
        "title": "Rapport d'extraction des appels",
        "type": "extract",
        "user": {
            "id": "usr-0ca9023b-b57b-4a5b-867b-e6858287575f",
            "created_at": "2024-03-04T08:06:08.000000Z",
            "email": "example@email.fr",
            "firstname": "John",
            "lang": "fr",
            "lastname": "Doe",
            "phone": "03 62 XX XX XX"
        }
    },
    "meta": {
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2024-03-04 09:12:08",
            "expiration": null,
            "level": "account",
            "name": "My account"
        },
        "total": 4
    }
}

Fetch a report

GET

https://api.magnetis.io

/reports/{id}

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

The id of the report

required

Example:

rep-c1e6945d-c21b-4bfb-82f8-b08eb7f8128e

Response Fields

string

ID of the report

accounts

string[]

Array of accounts linked to the report (only with network api key)

account

object

Account linked to the report (only with account api key)

all

boolean

Define if the report need to be send to every user in the account or only for choosen emails

created_at

datetime

Report creation date. Format: YYYY-MM-DD HH:mm:ss

period

string

Define period use to generate the report. Enum: daily,weekly,monthly

day_week

integer

Define the day on which the report must be send. Sunday is equal to 0. Only for weekly period

day_month

integer

Define the day on which the report must be send. The last day of the month is equal to 28. Only for monthly period

enabled

boolean

Active status of the report

private

boolean

Define if the report can be only view by the creator or everyone in the account. Only for reports created in our interface.

network

object

Network linked to this report, used in combination with the accounts field

recipients

string[]

Array of email the report will be sent to

sender

string

The left part of the sender email adress before @

subject

string

Email subject

title

string

Report title

type

string

Report type. Enum: synthesis, comparative, lostcall, extract

user

object

If created from our interface, the user who created the report is linked here

Example request:

curl --request GET \
    --get "https://api.magnetis.io/reports/rep-c1e6945d-c21b-4bfb-82f8-b08eb7f8128e" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": {
        "id": "rep-5345fd1a-7331-4242-ab5c-71de77e33818",
        "accounts": [],
        "account": {
            "id": "acc-f27c03a5-9498-4dd1-aeeb-30722b219f2e",
            "name": "Immobilier tertiaire"
        },
        "all": false,
        "created_at": "2024-03-04 09:06:09",
        "period": "monthly",
        "day_week": null,
        "day_month": 12,
        "private": 1,
        "network": null,
        "recipients": [
            {
                "email": "example@email.fr",
                "type": "to"
            }
        ],
        "sender": "contact@email.fr",
        "subject": "",
        "title": "Rapport d'extraction des appels",
        "type": "extract",
        "user": {
            "id": "usr-0ca9023b-b57b-4a5b-867b-e6858287575f",
            "created_at": "2024-03-04T08:06:08.000000Z",
            "email": "example@email.fr",
            "firstname": "John",
            "lang": "fr",
            "lastname": "Doe",
            "phone": "03 62 XX XX XX"
        }
    },
    "meta": {
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2024-03-04 09:12:08",
            "expiration": null,
            "level": "account",
            "name": "My account"
        },
        "total": 4
    }
}

Update a report

PUT

PATCH

https://api.magnetis.io

/reports/{id}

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

The id of the report

required

Example:

rep-c1e6945d-c21b-4bfb-82f8-b08eb7f8128e

Body Parameters

accounts

string[]

List of account IDs used to generate report statistics if it is linked to a network

Example:

[acc-6e64b651-026a-46de-ab3e-944a193945a9, acc-cf162a0f-8ea4-4aad-999c-81f8e85cb033]

sender

string

required

Sender of the report, in lowercase (left part of the email, before @)

Example:

contact

all

boolean

Need to be true if you want to send the report to all user who have access to it and with no additional recipients

recipients

object[]

Array of email you want to send the report, required when all is not set or false.

subject

string

required

Subject of the email

Example:

Call-tracking report

title

string

required

Title of the report.
Used to recognize report.

Example:

My statistic report

type

string

required

Report type. Enum: synthesis, comparative, lostcall, extract

Example:

synthesis

period

string

required

Define period use to generate the report. Enum: daily, weekly, monthly

Example:

weekly

day_week

integer

Must be between 0 and 6.
0: Sunday
6: Saturday

Example:

day_month

integer

Must be between 1 and 28.
1: the first day of the month
28: the last day of the month

Example:

null

enabled

boolean

required

Determines if the report is active

Response Fields

string

ID of the report

accounts

string[]

Array of accounts linked to the report (only with network api key)

account

object

Account linked to the report (only with account api key)

all

boolean

Define if the report need to be send to every user in the account or only for choosen emails

created_at

datetime

Report creation date. Format: YYYY-MM-DD HH:mm:ss

period

string

Define period use to generate the report. Enum: daily,weekly,monthly

day_week

integer

Define the day on which the report must be send. Sunday is equal to 0. Only for weekly period

day_month

integer

Define the day on which the report must be send. The last day of the month is equal to 28. Only for monthly period

enabled

boolean

Active status of the report

private

boolean

Define if the report can be only view by the creator or everyone in the account. Only for reports created in our interface.

network

object

Network linked to this report, used in combination with the accounts field

recipients

string[]

Array of email the report will be sent to

sender

string

The left part of the sender email adress before @

subject

string

Email subject

title

string

Report title

type

string

Report type. Enum: synthesis, comparative, lostcall, extract

user

object

If created from our interface, the user who created the report is linked here

Example request:

curl --request PUT \
    "https://api.magnetis.io/reports/rep-c1e6945d-c21b-4bfb-82f8-b08eb7f8128e" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"accounts\": \"[acc-6e64b651-026a-46de-ab3e-944a193945a9, acc-cf162a0f-8ea4-4aad-999c-81f8e85cb033]\",
    \"sender\": \"contact\",
    \"all\": false,
    \"recipients\": [
        {
            \"email\": \"email@test.fr\",
            \"type\": \"to\"
        }
    ],
    \"subject\": \"Call-tracking report\",
    \"title\": \"My statistic report\",
    \"type\": \"synthesis\",
    \"period\": \"weekly\",
    \"day_week\": \"1\",
    \"day_month\": \"null\",
    \"enabled\": false
}"

Example response:

{
    "data": {
        "id": "rep-5345fd1a-7331-4242-ab5c-71de77e33818",
        "accounts": [],
        "account": {
            "id": "acc-f27c03a5-9498-4dd1-aeeb-30722b219f2e",
            "name": "Immobilier tertiaire"
        },
        "all": false,
        "created_at": "2024-03-04 09:06:09",
        "period": "monthly",
        "day_week": null,
        "day_month": 12,
        "private": 1,
        "network": null,
        "recipients": [
            {
                "email": "example@email.fr",
                "type": "to"
            }
        ],
        "sender": "contact@email.fr",
        "subject": "",
        "title": "Rapport d'extraction des appels",
        "type": "extract",
        "user": {
            "id": "usr-0ca9023b-b57b-4a5b-867b-e6858287575f",
            "created_at": "2024-03-04T08:06:08.000000Z",
            "email": "example@email.fr",
            "firstname": "John",
            "lang": "fr",
            "lastname": "Doe",
            "phone": "03 62 XX XX XX"
        }
    },
    "meta": {
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2024-03-04 09:12:08",
            "expiration": null,
            "level": "account",
            "name": "My account"
        },
        "total": 4
    }
}

Delete a report

DELETE

https://api.magnetis.io

/reports/{id}

requires authentication

Headers

x-api-key

Example:

{YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

The id of the report

required

Example:

rep-c1e6945d-c21b-4bfb-82f8-b08eb7f8128e

Response Fields

string

ID of the report

accounts

string[]

Array of accounts linked to the report (only with network api key)

account

object

Account linked to the report (only with account api key)

all

boolean

Define if the report need to be send to every user in the account or only for choosen emails

created_at

datetime

Report creation date. Format: YYYY-MM-DD HH:mm:ss

period

string

Define period use to generate the report. Enum: daily,weekly,monthly

day_week

integer

Define the day on which the report must be send. Sunday is equal to 0. Only for weekly period

day_month

integer

Define the day on which the report must be send. The last day of the month is equal to 28. Only for monthly period

enabled

boolean

Active status of the report

private

boolean

Define if the report can be only view by the creator or everyone in the account. Only for reports created in our interface.

network

object

Network linked to this report, used in combination with the accounts field

recipients

string[]

Array of email the report will be sent to

sender

string

The left part of the sender email adress before @

subject

string

Email subject

title

string

Report title

type

string

Report type. Enum: synthesis, comparative, lostcall, extract

user

object

If created from our interface, the user who created the report is linked here

Example request:

curl --request DELETE \
    "https://api.magnetis.io/reports/rep-c1e6945d-c21b-4bfb-82f8-b08eb7f8128e" \
    --header "x-api-key: {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [],
    "meta": {
        "apiKey": {
            "id": "key-d464804c-61a5-494b-a2ce-db765f5691c2",
            "created_at": "2023-07-25 12:00:00",
            "expiration": null,
            "level": "account",
            "name": "My account"
        },
        "total": 0
    }
}