POST
/
v2.01
/
{ClientId}
/
hooks
{
    "Url": "https://example.com",
    "EventType" : "PAYIN_REFUND_SUCCEEDED",
    "Tag": "Created using the Mangopay API Postman Collection"
}  

{
    "Url": "https://example.com",
    "Status": "ENABLED",
    "Validity": "VALID",
    "EventType": "PAYIN_REFUND_SUCCEEDED",
    "Id": "hook_m_01J8F5RK4R43AYWD8XVG9RSYDT",
    "Tag": "Created using the Mangopay API Postman Collection",
    "CreationDate": 1727086218
}
NoteYou can only create one Hook for each EventType.

​
Body parameters

​
EventType
string
required
Allowed values: An EventType listed in the event types listThe type of the event.
​
Url
string
required
Max. length: 255 charactersThe URL to which the notification is sent.
​
Tag
string
Max. length: 255 charactersCustom data that you can add to this object.

​
Responses

{
    "Url": "https://example.com",
    "Status": "ENABLED",
    "Validity": "VALID",
    "EventType": "PAYIN_REFUND_SUCCEEDED",
    "Id": "hook_m_01J8F5RK4R43AYWD8XVG9RSYDT",
    "Tag": "Created using the Mangopay API Postman Collection",
    "CreationDate": 1727086218
}

{
    "Url": "https://example.com",
    "EventType" : "PAYIN_REFUND_SUCCEEDED",
    "Tag": "Created using the Mangopay API Postman Collection"
}