MMetadata /docs
⌘K
Docs/Tools/disconnect_channel

disconnect_channel

Disconnect a specific advertising channel from the Metadata platform.

Destructive campaigns

Deletes, archives, launches or moves budget. Do not give an agent this one without a human gate.

What it does

Disconnect a specific advertising channel from the Metadata platform.

                    USAGE INSTRUCTIONS FOR LLM:
                    Use this tool to disconnect/remove integration connections for advertising channels.
                    This is useful when users need to remove a channel integration or reconnect with different credentials.

                    WHEN TO USE THIS TOOL:
                    - User asks to "disconnect [channel name]"
                    - User wants to "remove [channel] integration"
                    - User needs to "unlink [channel] account"
                    - User wants to "revoke [channel] access"
                    - User asks to "disconnect my Facebook/LinkedIn/Twitter/Reddit/Google account"
                    - User needs to "reset [channel] connection"
                    - Preparing to reconnect a channel with different credentials

                    SUPPORTED CHANNELS:
                    - facebook: Disconnect Facebook advertising account
                    - instagram: Disconnect Instagram advertising account
                    - linkedin: Disconnect LinkedIn advertising account
                    - twitter: Disconnect Twitter/X advertising account
                    - reddit: Disconnect Reddit advertising account
                    - google: Disconnect Google Ads account

                    IMPORTANT NOTES:
                    - This action will disconnect the channel immediately
                    - Any active campaigns on this channel may be affected
                    - The user will need to reconnect the channel to resume advertising
                    - Always confirm with the user before disconnecting a channel
                    - Check integration status first using get_integrations_status to verify the channel is connected

                    COMMON SCENARIOS:

                    Scenario 1 - Disconnect single channel: "Disconnect my LinkedIn account"
                    → Call disconnect_channel with channel="linkedin"

                    Scenario 2 - Reconnect workflow: "I want to reconnect Facebook with a different account"
                    → First call disconnect_channel with channel="facebook", then guide user to reconnect

                    Scenario 3 - Remove access: "Remove Google Ads integration"
                    → Call disconnect_channel with channel="google"

                    RESPONSE FORMAT:
                    Returns a success/failure status indicating whether the channel was disconnected successfully.

                    EXAMPLE: "Disconnect Facebook" → disconnect_channel(channel="facebook")

Arguments

ArgumentTypeNotes
channel string required The channel to disconnect. Must be one of: reddit, facebook, linkedin, twitter, google, instagram
one of: reddit, facebook, linkedin, twitter, google, instagram

Request

curl
curl -s -X POST https://mcp-server.metadata.io/mcp \
  -H "Authorization: $METADATA_PAT" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"disconnect_channel","arguments":{"channel":"reddit"}}}'

Response

No recorded response. This tool can delete, archive, launch or move budget, so it is never executed to build these docs. The request above is still the exact shape to send. Nothing on this page is invented.

Other campaigns tools:

All 160 tools · machine-readable index