Change marketing settings

Whether manitu may send news and offers by mail; the partner programme.

WWriteIdempotentbetaNeeds account

Tool

manitu_account_marketing_seton https://mcp.manitu.de/mcp

POST

/v1/account/marketing/seton https://api.manitu.de

Try it

Changes the account. Agents say what will happen and wait for an explicit yes before calling it.

Annotations as tools/list sends them

readOnlyHint falsedestructiveHint falseidempotentHint trueopenWorldHint false

Description for the model

Sets whether manitu may send news and offers by mail to the manitu customer account this connection works in (mailing_misc), and whether the account takes part in manitu's partner programme (affiliate_partner); send only what is to change. Notices about the account's own services and invoices are sent either way. Only when the customer asks for exactly this - it is his consent to advertising; say what will change and ask for an explicit yes first. Returns the settings as manitu_account_marketing_get shows them. Refused if this access may not change the account's base data.

Arguments

mailing_miscboolean

true: manitu may send news and offers by mail; false: not.

affiliate_partnerboolean

true: the account takes part in the partner programme and gets an id (an existing one stays); false: it leaves it, the id is gone.

Result structuredContent, checked against the schema

account_idintegerrequired

The customer account - its id is also its customer number.

mailing_miscbooleanrequired

Whether manitu may send news and offers by mail. Notices about the account's own services and invoices are sent either way.

affiliate_partner_idstring | nullrequired

The account's id in manitu's partner programme; null: not taking part.

Authentication

One of X-API-Key, Authorization: Bearer … - never more than one in a request. More

Request body JSON; unknown fields are refused

Send at least 1 field(s).

mailing_miscboolean

true: manitu may send news and offers by mail; false: not.

affiliate_partnerboolean

true: the account takes part in the partner programme and gets an id (an existing one stays); false: it leaves it, the id is gone.

Response in `data`; the rest of the body as on every call

account_idintegerrequired

The customer account - its id is also its customer number.

mailing_miscbooleanrequired

Whether manitu may send news and offers by mail. Notices about the account's own services and invoices are sent either way.

affiliate_partner_idstring | nullrequired

The account's id in manitu's partner programme; null: not taking part.

Statuses

200Success.400The request does not match the declared input schema.401No credential was presented, or it was not recognised.403The credential is not permitted to use this operation.500The server failed. Nothing about the request was wrong. Whether a change took effect is not known - check before trying it again.503The channel this operation forwards through is unavailable.

MCPtools/call

Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "manitu_account_marketing_set",
    "arguments": {}
  }
}

Result

{
  "structuredContent": {
    "account_id": 12345,
    "mailing_misc": true,
    "affiliate_partner_id": "string"
  },
  "content": [
    {
      "type": "text",
      "text": "… the same answer as text …"
    }
  ],
  "isError": false
}

POST/v1/account/marketing/set

Request

curl -X POST 'https://api.manitu.de/v1/account/marketing/set' \
  -H 'X-API-Key: $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{}'

const response = await fetch('https://api.manitu.de/v1/account/marketing/set', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
});
const answer = await response.json();

<?php

$curl = curl_init('https://api.manitu.de/v1/account/marketing/set');

curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_HTTPHEADER     => [
        'X-API-Key: ' . getenv('API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS     => '{}',
    CURLOPT_RETURNTRANSFER => true,
]);

$answer = json_decode(curl_exec($curl), true);

import os

import requests

response = requests.request(
    "POST",
    "https://api.manitu.de/v1/account/marketing/set",
    headers={"X-API-Key": os.environ["API_KEY"]},
    json={},
)
answer = response.json()

Response 200

{
  "status": {
    "type": "success",
    "code": 200
  },
  "meta": {},
  "data": {
    "account_id": 12345,
    "mailing_misc": true,
    "affiliate_partner_id": "string"
  }
}

Change marketing settings

Annotations as tools/list sends them

Description for the model

Arguments

Result structuredContent, checked against the schema

Authentication

Request body JSON; unknown fields are refused

Response in data; the rest of the body as on every call

Statuses

Response in `data`; the rest of the body as on every call