hostinger-api-mcp 1.30.0 → 1.32.0

package/src/core/tools/reach.js

@@ -2,7 +2,7 @@
 export default [
   {
     "name": "reach_deleteAContactV1",
-    "description": "Delete a contact with the specified UUID.\n\nThis endpoint permanently removes a contact from the email marketing system.",
+    "description": "Delete a contact with the specified UUID.\n\nThis endpoint permanently removes a contact from the email marketing system.\n\n**Deprecated.** This endpoint cannot target a profile, so it always falls back to the\nclient's default profile and cannot delete contacts of any other profile. Use\n`DELETE /api/reach/v1/profiles/{profileUuid}/contacts/{contactUuid}` instead.",
     "method": "DELETE",
     "path": "/api/reach/v1/contacts/{uuid}",
     "inputSchema": {
@@ -24,6 +24,163 @@ export default [
     ],
     "group": "reach"
   },
+  {
+    "name": "reach_deleteAContactFieldV1",
+    "description": "Delete a custom contact field.\n\nEvery value contacts hold for the field is deleted with it, and for the choice types so\nare its options. The contacts themselves are not affected.",
+    "method": "DELETE",
+    "path": "/api/reach/v1/profiles/{profileUuid}/contacts/fields/{fieldUuid}",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "profileUuid": {
+          "type": "string",
+          "description": "Profile uuid parameter"
+        },
+        "fieldUuid": {
+          "type": "string",
+          "description": "Contact field uuid parameter"
+        }
+      },
+      "required": [
+        "profileUuid",
+        "fieldUuid"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "reach"
+  },
+  {
+    "name": "reach_updateAContactFieldV1",
+    "description": "Rename a custom contact field and, for the choice types, replace its option set.\n\nOptions carrying a uuid are kept and relabelled, options without one are created, and any\nexisting option left out of the list is deleted along with the values contacts hold for\nit. The field type and slug cannot be changed.",
+    "method": "PATCH",
+    "path": "/api/reach/v1/profiles/{profileUuid}/contacts/fields/{fieldUuid}",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "profileUuid": {
+          "type": "string",
+          "description": "Profile uuid parameter"
+        },
+        "fieldUuid": {
+          "type": "string",
+          "description": "Contact field uuid parameter"
+        },
+        "label": {
+          "type": "string",
+          "description": "label parameter"
+        },
+        "options": {
+          "type": "array",
+          "description": "Replaces the option set when provided. Entries carrying a uuid are kept and relabelled, entries without one are created, and any existing option missing from the list is deleted along with the values contacts hold for it.",
+          "items": {
+            "type": "object",
+            "description": "options parameter",
+            "properties": {
+              "uuid": {
+                "type": "string",
+                "description": "uuid parameter"
+              },
+              "label": {
+                "type": "string",
+                "description": "label parameter"
+              }
+            },
+            "required": [
+              "label"
+            ]
+          }
+        }
+      },
+      "required": [
+        "profileUuid",
+        "fieldUuid",
+        "label"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "reach"
+  },
+  {
+    "name": "reach_listContactFieldsV1",
+    "description": "Get the custom contact fields defined in a profile.\n\nCustom fields let you store your own attributes on contacts. The returned uuids are what\nyou pass to the contact update endpoint to set values, and choice fields also list the\noptions available to pick from.",
+    "method": "GET",
+    "path": "/api/reach/v1/profiles/{profileUuid}/contacts/fields",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "profileUuid": {
+          "type": "string",
+          "description": "Profile uuid parameter"
+        }
+      },
+      "required": [
+        "profileUuid"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "reach"
+  },
+  {
+    "name": "reach_createAContactFieldV1",
+    "description": "Define a new custom contact field in a profile.\n\nThe `slug` is derived from the label and, like the field type, cannot be changed later.\nUse the returned uuid to set values on contacts.",
+    "method": "POST",
+    "path": "/api/reach/v1/profiles/{profileUuid}/contacts/fields",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "profileUuid": {
+          "type": "string",
+          "description": "Profile uuid parameter"
+        },
+        "type": {
+          "type": "string",
+          "description": "Immutable once the field exists",
+          "enum": [
+            "text",
+            "number",
+            "date",
+            "single_choice",
+            "multi_choice"
+          ]
+        },
+        "label": {
+          "type": "string",
+          "description": "label parameter"
+        },
+        "options": {
+          "type": "array",
+          "description": "Required for single_choice and multi_choice, ignored for the scalar types. Labels must be unique regardless of casing.",
+          "items": {
+            "type": "string",
+            "description": "options parameter"
+          }
+        }
+      },
+      "required": [
+        "profileUuid",
+        "type",
+        "label"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "reach"
+  },
   {
     "name": "reach_listContactGroupsV1",
     "description": "Get a list of all contact groups.\n\nThis endpoint returns a list of contact groups that can be used to organize contacts.",
@@ -31,8 +188,296 @@ export default [
     "path": "/api/reach/v1/contacts/groups",
     "inputSchema": {
       "type": "object",
-      "properties": {},
-      "required": []
+      "properties": {},
+      "required": []
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "reach"
+  },
+  {
+    "name": "reach_listContactsV1",
+    "description": "Get a list of contacts, optionally filtered by group and subscription status.\n\nThis endpoint returns a paginated list of contacts with their basic information.\nYou can filter contacts by group UUID and subscription status.\n\n**Deprecated.** This endpoint cannot target a profile, so it always falls back to the\nclient's default profile and cannot list contacts of any other profile. Use\n`GET /api/reach/v1/profiles/{profileUuid}/contacts` instead, which also replaces the\ngroup filter with a tag filter.",
+    "method": "GET",
+    "path": "/api/reach/v1/contacts",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "group_uuid": {
+          "type": "string",
+          "description": "Filter contacts by group UUID"
+        },
+        "subscription_status": {
+          "type": "string",
+          "description": "Filter contacts by subscription status",
+          "enum": [
+            "subscribed",
+            "unsubscribed",
+            "confirmed",
+            "pending"
+          ]
+        },
+        "page": {
+          "type": "integer",
+          "description": "Page number"
+        }
+      },
+      "required": []
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "reach"
+  },
+  {
+    "name": "reach_createANewContactV1",
+    "description": "Create a new contact in the email marketing system.\n\nThis endpoint allows you to create a new contact with basic information like name, email, and surname.\n\nIf double opt-in is enabled,\nthe contact will be created with a pending status and a confirmation email will be sent.",
+    "method": "POST",
+    "path": "/api/reach/v1/contacts",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "email": {
+          "type": "string",
+          "description": "email parameter"
+        },
+        "name": {
+          "type": "string",
+          "description": "name parameter"
+        },
+        "surname": {
+          "type": "string",
+          "description": "surname parameter"
+        },
+        "phone": {
+          "type": "string",
+          "description": "Phone number in E.164 format (leading \"+\" then 7-15 digits)"
+        },
+        "note": {
+          "type": "string",
+          "description": "note parameter"
+        }
+      },
+      "required": [
+        "email"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "reach"
+  },
+  {
+    "name": "reach_getContactDetailsV1",
+    "description": "Get the full details of a single contact.\n\nAlongside the contact's own attributes this returns the tags assigned to it and the\nvalues it holds for the profile's custom contact fields.",
+    "method": "GET",
+    "path": "/api/reach/v1/profiles/{profileUuid}/contacts/{contactUuid}",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "profileUuid": {
+          "type": "string",
+          "description": "Profile uuid parameter"
+        },
+        "contactUuid": {
+          "type": "string",
+          "description": "Contact uuid parameter"
+        }
+      },
+      "required": [
+        "profileUuid",
+        "contactUuid"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "reach"
+  },
+  {
+    "name": "reach_deleteAProfileContactV1",
+    "description": "Permanently delete a contact from a profile.\n\nThe contact is removed together with its custom field values and tag assignments.",
+    "method": "DELETE",
+    "path": "/api/reach/v1/profiles/{profileUuid}/contacts/{contactUuid}",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "profileUuid": {
+          "type": "string",
+          "description": "Profile uuid parameter"
+        },
+        "contactUuid": {
+          "type": "string",
+          "description": "Contact uuid parameter"
+        }
+      },
+      "required": [
+        "profileUuid",
+        "contactUuid"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "reach"
+  },
+  {
+    "name": "reach_updateAContactV1",
+    "description": "Update a contact's attributes and custom field values.\n\nOnly the properties present in the request body are changed, so a partial body is enough\nto change a single attribute. Sending a property as `null` clears it.\n\nThe response carries the contact's core attributes. Read back its tags, custom field\nvalues, source and note with `GET /api/reach/v1/profiles/{profileUuid}/contacts/{contactUuid}`.",
+    "method": "PATCH",
+    "path": "/api/reach/v1/profiles/{profileUuid}/contacts/{contactUuid}",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "profileUuid": {
+          "type": "string",
+          "description": "Profile uuid parameter"
+        },
+        "contactUuid": {
+          "type": "string",
+          "description": "Contact uuid parameter"
+        },
+        "email": {
+          "type": "string",
+          "description": "email parameter"
+        },
+        "name": {
+          "type": "string",
+          "description": "name parameter"
+        },
+        "surname": {
+          "type": "string",
+          "description": "surname parameter"
+        },
+        "phone": {
+          "type": "string",
+          "description": "Phone number in E.164 format (leading \"+\" then 7-15 digits)"
+        },
+        "subscription_status": {
+          "type": "string",
+          "description": "subscription_status parameter",
+          "enum": [
+            "subscribed",
+            "unsubscribed",
+            "confirmed",
+            "pending"
+          ]
+        },
+        "note": {
+          "type": "string",
+          "description": "note parameter"
+        },
+        "fields": {
+          "type": "array",
+          "description": "Set custom field values. Omit to leave untouched, send an empty array to clear them all.",
+          "items": {
+            "type": "object",
+            "description": "fields parameter",
+            "properties": {
+              "uuid": {
+                "type": "string",
+                "description": "uuid parameter"
+              },
+              "value": {
+                "type": "string",
+                "description": "For the scalar field types"
+              },
+              "selected_option_uuids": {
+                "type": "array",
+                "description": "For the choice field types",
+                "items": {
+                  "type": "string",
+                  "description": "selected_option_uuids parameter"
+                }
+              }
+            },
+            "required": [
+              "uuid"
+            ]
+          }
+        }
+      },
+      "required": [
+        "profileUuid",
+        "contactUuid"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "reach"
+  },
+  {
+    "name": "reach_createContactsInBulkV1",
+    "description": "Create many contacts in a profile in a single call.\n\nThe contacts are imported in the background, so a success response means the import was\naccepted rather than finished. Contacts whose email already exists in the profile are\nleft as they are. If double opt-in is enabled, new contacts start off pending and are\nsent a confirmation email.",
+    "method": "POST",
+    "path": "/api/reach/v1/profiles/{profileUuid}/contacts/bulk",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "profileUuid": {
+          "type": "string",
+          "description": "Profile uuid parameter"
+        },
+        "contacts": {
+          "type": "array",
+          "description": "contacts parameter",
+          "items": {
+            "type": "object",
+            "description": "contacts parameter",
+            "properties": {
+              "email": {
+                "type": "string",
+                "description": "email parameter"
+              },
+              "name": {
+                "type": "string",
+                "description": "name parameter"
+              },
+              "surname": {
+                "type": "string",
+                "description": "surname parameter"
+              },
+              "phone": {
+                "type": "string",
+                "description": "Phone number in E.164 format (leading \"+\" then 7-15 digits)"
+              }
+            },
+            "required": [
+              "email"
+            ]
+          }
+        },
+        "tag_uuids": {
+          "type": "array",
+          "description": "Existing tags to attach to every created contact",
+          "items": {
+            "type": "string",
+            "description": "tag_uuids parameter"
+          }
+        },
+        "note": {
+          "type": "string",
+          "description": "Note applied to every created contact"
+        }
+      },
+      "required": [
+        "profileUuid",
+        "contacts"
+      ]
     },
     "security": [
       {
@@ -42,31 +487,47 @@ export default [
     "group": "reach"
   },
   {
-    "name": "reach_listContactsV1",
-    "description": "Get a list of contacts, optionally filtered by group and subscription status.\n\nThis endpoint returns a paginated list of contacts with their basic information.\nYou can filter contacts by group UUID and subscription status.",
+    "name": "reach_listProfileContactsV1",
+    "description": "Get a paginated list of contacts belonging to a profile.\n\nContacts can be filtered by subscription status, by tag, and by an email search term.\nThe `meta.total` field of the response is the number of contacts matching the filters,\nso calling this endpoint without filters gives the profile's total contact count.",
     "method": "GET",
-    "path": "/api/reach/v1/contacts",
+    "path": "/api/reach/v1/profiles/{profileUuid}/contacts",
     "inputSchema": {
       "type": "object",
       "properties": {
-        "group_uuid": {
+        "profileUuid": {
           "type": "string",
-          "description": "Filter contacts by group UUID"
+          "description": "Profile uuid parameter"
         },
         "subscription_status": {
           "type": "string",
           "description": "Filter contacts by subscription status",
           "enum": [
             "subscribed",
-            "unsubscribed"
+            "unsubscribed",
+            "confirmed",
+            "pending"
           ]
         },
+        "tag_uuid": {
+          "type": "string",
+          "description": "Filter contacts by tag UUID"
+        },
+        "search": {
+          "type": "string",
+          "description": "Search contacts by email"
+        },
         "page": {
           "type": "integer",
           "description": "Page number"
+        },
+        "per_page": {
+          "type": "integer",
+          "description": "Number of items per page"
         }
       },
-      "required": []
+      "required": [
+        "profileUuid"
+      ]
     },
     "security": [
       {
@@ -76,13 +537,17 @@ export default [
     "group": "reach"
   },
   {
-    "name": "reach_createANewContactV1",
-    "description": "Create a new contact in the email marketing system.\n\nThis endpoint allows you to create a new contact with basic information like name, email, and surname.\n\nIf double opt-in is enabled,\nthe contact will be created with a pending status and a confirmation email will be sent.",
+    "name": "reach_createNewContactsV1",
+    "description": "Create a new contact in the email marketing system.\n\nThis endpoint allows you to create a new contact with basic information like name, email, and surname.\n\nIf double opt-in is enabled, the contact will be created with a pending status\nand a confirmation email will be sent.",
     "method": "POST",
-    "path": "/api/reach/v1/contacts",
+    "path": "/api/reach/v1/profiles/{profileUuid}/contacts",
     "inputSchema": {
       "type": "object",
       "properties": {
+        "profileUuid": {
+          "type": "string",
+          "description": "Profile uuid parameter"
+        },
         "email": {
           "type": "string",
           "description": "email parameter"
@@ -105,6 +570,7 @@ export default [
         }
       },
       "required": [
+        "profileUuid",
         "email"
       ]
     },
@@ -330,10 +796,10 @@ export default [
     "group": "reach"
   },
   {
-    "name": "reach_createNewContactsV1",
-    "description": "Create a new contact in the email marketing system.\n\nThis endpoint allows you to create a new contact with basic information like name, email, and surname.\n\nIf double opt-in is enabled, the contact will be created with a pending status\nand a confirmation email will be sent.",
+    "name": "reach_assignAContactToATagV1",
+    "description": "Assign a tag to a single contact.\n\nUnlike the bulk endpoint this is applied immediately rather than queued. Assigning a tag\nthe contact already carries succeeds without duplicating it.",
     "method": "POST",
-    "path": "/api/reach/v1/profiles/{profileUuid}/contacts",
+    "path": "/api/reach/v1/profiles/{profileUuid}/tags/{tagUuid}/contacts/{contactUuid}",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -341,30 +807,243 @@ export default [
           "type": "string",
           "description": "Profile uuid parameter"
         },
-        "email": {
+        "tagUuid": {
           "type": "string",
-          "description": "email parameter"
+          "description": "Tag uuid parameter"
         },
-        "name": {
+        "contactUuid": {
           "type": "string",
-          "description": "name parameter"
+          "description": "Contact uuid parameter"
+        }
+      },
+      "required": [
+        "profileUuid",
+        "tagUuid",
+        "contactUuid"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "reach"
+  },
+  {
+    "name": "reach_removeAContactFromATagV1",
+    "description": "Remove a tag from a single contact.\n\nUnlike the bulk endpoint this is applied immediately rather than queued. Neither the tag\nnor the contact is deleted.",
+    "method": "DELETE",
+    "path": "/api/reach/v1/profiles/{profileUuid}/tags/{tagUuid}/contacts/{contactUuid}",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "profileUuid": {
+          "type": "string",
+          "description": "Profile uuid parameter"
         },
-        "surname": {
+        "tagUuid": {
           "type": "string",
-          "description": "surname parameter"
+          "description": "Tag uuid parameter"
         },
-        "phone": {
+        "contactUuid": {
           "type": "string",
-          "description": "Phone number in E.164 format (leading \"+\" then 7-15 digits)"
+          "description": "Contact uuid parameter"
+        }
+      },
+      "required": [
+        "profileUuid",
+        "tagUuid",
+        "contactUuid"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "reach"
+  },
+  {
+    "name": "reach_assignContactsToATagV1",
+    "description": "Assign a tag to many contacts at once.\n\nPass `contact_uuids` to target specific contacts, or `all_contacts` to target every contact\nin the profile. The work is queued, so a success response means it was accepted rather than\nfinished. Contacts that already carry the tag are left alone.",
+    "method": "POST",
+    "path": "/api/reach/v1/profiles/{profileUuid}/tags/{tagUuid}/contacts",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "profileUuid": {
+          "type": "string",
+          "description": "Profile uuid parameter"
         },
-        "note": {
+        "tagUuid": {
           "type": "string",
-          "description": "note parameter"
+          "description": "Tag uuid parameter"
+        },
+        "contact_uuids": {
+          "type": "array",
+          "description": "Contacts to apply the change to. Required unless all_contacts is true.",
+          "items": {
+            "type": "string",
+            "description": "contact_uuids parameter"
+          }
+        },
+        "all_contacts": {
+          "type": "boolean",
+          "description": "Apply to every contact in the profile"
         }
       },
       "required": [
         "profileUuid",
-        "email"
+        "tagUuid"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "reach"
+  },
+  {
+    "name": "reach_removeContactsFromATagV1",
+    "description": "Remove a tag from many contacts at once.\n\nPass `contact_uuids` to target specific contacts, or `all_contacts` to target every contact\nin the profile. The work is queued, so a success response means it was accepted rather than\nfinished. The tag itself and the contacts are not deleted.",
+    "method": "DELETE",
+    "path": "/api/reach/v1/profiles/{profileUuid}/tags/{tagUuid}/contacts",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "profileUuid": {
+          "type": "string",
+          "description": "Profile uuid parameter"
+        },
+        "tagUuid": {
+          "type": "string",
+          "description": "Tag uuid parameter"
+        }
+      },
+      "required": [
+        "profileUuid",
+        "tagUuid"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "reach"
+  },
+  {
+    "name": "reach_deleteATagV1",
+    "description": "Delete a tag and remove it from every contact carrying it.\n\nThe contacts themselves are not deleted. This is idempotent: deleting a tag that does not\nexist in the profile still succeeds.",
+    "method": "DELETE",
+    "path": "/api/reach/v1/profiles/{profileUuid}/tags/{tagUuid}",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "profileUuid": {
+          "type": "string",
+          "description": "Profile uuid parameter"
+        },
+        "tagUuid": {
+          "type": "string",
+          "description": "Tag uuid parameter"
+        }
+      },
+      "required": [
+        "profileUuid",
+        "tagUuid"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "reach"
+  },
+  {
+    "name": "reach_renameATagV1",
+    "description": "Rename a tag.\n\nThe contacts assigned to the tag are unaffected. Names are unique within a profile, so\nrenaming a tag to a name that is already taken is rejected.",
+    "method": "PATCH",
+    "path": "/api/reach/v1/profiles/{profileUuid}/tags/{tagUuid}",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "profileUuid": {
+          "type": "string",
+          "description": "Profile uuid parameter"
+        },
+        "tagUuid": {
+          "type": "string",
+          "description": "Tag uuid parameter"
+        },
+        "value": {
+          "type": "string",
+          "description": "New tag name"
+        }
+      },
+      "required": [
+        "profileUuid",
+        "tagUuid",
+        "value"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "reach"
+  },
+  {
+    "name": "reach_listProfileTagsV1",
+    "description": "Get all tags defined in a profile.\n\nTags are the way contacts are grouped in Reach, and can be used to filter the contact\nlist or to build segments.",
+    "method": "GET",
+    "path": "/api/reach/v1/profiles/{profileUuid}/tags",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "profileUuid": {
+          "type": "string",
+          "description": "Profile uuid parameter"
+        }
+      },
+      "required": [
+        "profileUuid"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "reach"
+  },
+  {
+    "name": "reach_createOrFindTagsV1",
+    "description": "Create tags in a profile.\n\nNames that already exist in the profile are not duplicated: the existing tag is returned\ninstead, so the call is safe to repeat. Every tag in the request is returned, whether it\nwas created now or already existed.",
+    "method": "POST",
+    "path": "/api/reach/v1/profiles/{profileUuid}/tags",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "profileUuid": {
+          "type": "string",
+          "description": "Profile uuid parameter"
+        },
+        "names": {
+          "type": "array",
+          "description": "names parameter",
+          "items": {
+            "type": "string",
+            "description": "names parameter"
+          }
+        }
+      },
+      "required": [
+        "profileUuid",
+        "names"
       ]
     },
     "security": [