{
  "service": "buttondown",
  "displayName": "Buttondown",
  "categories": [
    "Marketing",
    "Communication"
  ],
  "authTypes": [
    "api_key"
  ],
  "auth": [
    {
      "type": "api_key",
      "label": "API Key",
      "placeholder": "BUTTONDOWN_API_KEY",
      "description": "Buttondown API key passed as Authorization: Token <api_key>. Find it on the Buttondown API requests page: https://buttondown.com/requests.",
      "extraFields": []
    }
  ],
  "homepageUrl": "https://buttondown.com",
  "actions": [
    {
      "id": "buttondown.create_subscriber",
      "service": "buttondown",
      "name": "create_subscriber",
      "description": "Create a Buttondown subscriber.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "email_address": {
            "type": "string",
            "maxLength": 254,
            "description": "The email address of the subscriber.",
            "format": "email"
          },
          "notes": {
            "type": "string",
            "description": "Any private notes to attach to the subscriber."
          },
          "metadata": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "A structured key-value blob stored on the Buttondown object."
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1,
              "description": "A tag name."
            },
            "description": "Tag names to apply to the subscriber. Tags that do not already exist will be created."
          },
          "referrer_url": {
            "type": "string",
            "description": "The URL the subscriber was referred from."
          },
          "utm_campaign": {
            "type": "string",
            "maxLength": 300,
            "description": "The UTM campaign attributed to the subscriber."
          },
          "utm_medium": {
            "type": "string",
            "maxLength": 300,
            "description": "The UTM medium attributed to the subscriber."
          },
          "utm_source": {
            "type": "string",
            "maxLength": 300,
            "description": "The UTM source attributed to the subscriber."
          },
          "type": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "regular",
                  "premium",
                  "unactivated",
                  "unsubscribed",
                  "removed"
                ],
                "description": "The subscriber lifecycle state returned by Buttondown."
              },
              {
                "type": "null"
              }
            ]
          },
          "ip_address": {
            "anyOf": [
              {
                "type": "string",
                "description": "The IP address of the subscriber."
              },
              {
                "type": "null"
              }
            ]
          },
          "collision_behavior": {
            "type": "string",
            "enum": [
              "add",
              "overwrite"
            ],
            "description": "Behavior to apply when a record with the same value exists."
          },
          "bypass_firewall": {
            "type": "boolean",
            "description": "Whether to bypass Buttondown's firewall for this subscriber creation."
          }
        },
        "additionalProperties": false,
        "required": [
          "email_address"
        ],
        "description": "The request payload for creating a Buttondown subscriber."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "subscriber": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "A unique TypeID associated with the subscriber."
              },
              "creation_date": {
                "type": "string",
                "description": "The date and time at which the subscriber was first created.",
                "format": "date-time"
              },
              "email_address": {
                "type": "string",
                "description": "The email address of the subscriber.",
                "format": "email"
              },
              "type": {
                "anyOf": [
                  {
                    "type": "string",
                    "enum": [
                      "regular",
                      "premium",
                      "unactivated",
                      "unsubscribed",
                      "removed"
                    ],
                    "description": "The subscriber lifecycle state returned by Buttondown."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "notes": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Private notes attached to the subscriber."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "metadata": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "A structured key-value blob stored on the Buttondown object."
              },
              "tags": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1
                },
                "description": "Tag names applied to the subscriber."
              },
              "avatar_url": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "URL of the subscriber's avatar image, if available."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "bounce_date": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "The date of the subscriber's most recent bounce event.",
                    "format": "date-time"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "churn_date": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "When the subscriber cancelled their paid subscription, if applicable.",
                    "format": "date-time"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "country": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "The ISO 3166-1 alpha-2 country code inferred at signup, if available."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "delivered_count": {
                "anyOf": [
                  {
                    "type": "integer",
                    "description": "The number of distinct emails delivered to this subscriber."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "open_count": {
                "anyOf": [
                  {
                    "type": "integer",
                    "description": "The subscriber's open count."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "clicked_count": {
                "anyOf": [
                  {
                    "type": "integer",
                    "description": "The subscriber's clicked count."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "open_rate": {
                "anyOf": [
                  {
                    "type": "number",
                    "description": "The subscriber's open rate, or null when unavailable."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "click_rate": {
                "anyOf": [
                  {
                    "type": "number",
                    "description": "The subscriber's click rate, or null when unavailable."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "raw": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "The raw Buttondown API object for advanced fields."
              }
            },
            "additionalProperties": true,
            "description": "A Buttondown subscriber."
          }
        },
        "additionalProperties": false,
        "required": [
          "subscriber"
        ],
        "description": "A Buttondown subscriber result."
      }
    },
    {
      "id": "buttondown.create_tag",
      "service": "buttondown",
      "name": "create_tag",
      "description": "Create a Buttondown tag.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100,
            "description": "The name of the tag."
          },
          "color": {
            "type": "string",
            "minLength": 4,
            "maxLength": 7,
            "description": "The hex color code associated with the tag.",
            "pattern": "^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})$"
          },
          "description": {
            "anyOf": [
              {
                "type": "string",
                "description": "An internal description of the tag."
              },
              {
                "type": "null"
              }
            ]
          },
          "public_description": {
            "anyOf": [
              {
                "type": "string",
                "description": "A public-facing description of the tag."
              },
              {
                "type": "null"
              }
            ]
          },
          "subscriber_editable": {
            "type": "boolean",
            "description": "Whether subscribers can add or remove this tag from their own profile."
          },
          "collision_behavior": {
            "type": "string",
            "enum": [
              "overwrite"
            ],
            "description": "Whether to overwrite an existing tag with the same name."
          }
        },
        "additionalProperties": false,
        "required": [
          "name",
          "color"
        ],
        "description": "The request payload for creating a Buttondown tag."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "tag": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "A Buttondown tag."
          }
        },
        "additionalProperties": false,
        "required": [
          "tag"
        ],
        "description": "A Buttondown tag result."
      }
    },
    {
      "id": "buttondown.delete_subscriber",
      "service": "buttondown",
      "name": "delete_subscriber",
      "description": "Delete a Buttondown subscriber by ID or email address.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "id_or_email": {
            "type": "string",
            "minLength": 1,
            "description": "The Buttondown subscriber ID or email address."
          }
        },
        "additionalProperties": false,
        "required": [
          "id_or_email"
        ],
        "description": "The subscriber lookup input."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "id_or_email": {
            "type": "string",
            "description": "The Buttondown subscriber ID or email address that was deleted."
          },
          "deleted": {
            "type": "boolean",
            "description": "Whether the connector completed the delete request."
          }
        },
        "additionalProperties": false,
        "required": [
          "id_or_email",
          "deleted"
        ],
        "description": "The Buttondown subscriber delete result."
      }
    },
    {
      "id": "buttondown.delete_tag",
      "service": "buttondown",
      "name": "delete_tag",
      "description": "Delete a Buttondown tag by ID.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "The Buttondown tag ID."
          }
        },
        "additionalProperties": false,
        "required": [
          "id"
        ],
        "description": "The tag lookup input."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The Buttondown tag ID that was deleted."
          },
          "deleted": {
            "type": "boolean",
            "description": "Whether the connector completed the delete request."
          }
        },
        "additionalProperties": false,
        "required": [
          "id",
          "deleted"
        ],
        "description": "The Buttondown tag delete result."
      }
    },
    {
      "id": "buttondown.get_account",
      "service": "buttondown",
      "name": "get_account",
      "description": "Get the account associated with the Buttondown API key.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {},
        "additionalProperties": false,
        "description": "The empty input payload for this Buttondown action."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "username": {
            "type": "string",
            "description": "The username associated with the account."
          },
          "email_address": {
            "type": "string",
            "description": "The email address associated with the account.",
            "format": "email"
          }
        },
        "additionalProperties": false,
        "required": [
          "username",
          "email_address"
        ],
        "description": "The connected Buttondown account."
      }
    },
    {
      "id": "buttondown.get_subscriber",
      "service": "buttondown",
      "name": "get_subscriber",
      "description": "Retrieve one Buttondown subscriber by ID or email address.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "id_or_email": {
            "type": "string",
            "minLength": 1,
            "description": "The Buttondown subscriber ID or email address."
          }
        },
        "additionalProperties": false,
        "required": [
          "id_or_email"
        ],
        "description": "The subscriber lookup input."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "subscriber": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "A unique TypeID associated with the subscriber."
              },
              "creation_date": {
                "type": "string",
                "description": "The date and time at which the subscriber was first created.",
                "format": "date-time"
              },
              "email_address": {
                "type": "string",
                "description": "The email address of the subscriber.",
                "format": "email"
              },
              "type": {
                "anyOf": [
                  {
                    "type": "string",
                    "enum": [
                      "regular",
                      "premium",
                      "unactivated",
                      "unsubscribed",
                      "removed"
                    ],
                    "description": "The subscriber lifecycle state returned by Buttondown."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "notes": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Private notes attached to the subscriber."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "metadata": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "A structured key-value blob stored on the Buttondown object."
              },
              "tags": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1
                },
                "description": "Tag names applied to the subscriber."
              },
              "avatar_url": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "URL of the subscriber's avatar image, if available."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "bounce_date": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "The date of the subscriber's most recent bounce event.",
                    "format": "date-time"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "churn_date": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "When the subscriber cancelled their paid subscription, if applicable.",
                    "format": "date-time"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "country": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "The ISO 3166-1 alpha-2 country code inferred at signup, if available."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "delivered_count": {
                "anyOf": [
                  {
                    "type": "integer",
                    "description": "The number of distinct emails delivered to this subscriber."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "open_count": {
                "anyOf": [
                  {
                    "type": "integer",
                    "description": "The subscriber's open count."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "clicked_count": {
                "anyOf": [
                  {
                    "type": "integer",
                    "description": "The subscriber's clicked count."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "open_rate": {
                "anyOf": [
                  {
                    "type": "number",
                    "description": "The subscriber's open rate, or null when unavailable."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "click_rate": {
                "anyOf": [
                  {
                    "type": "number",
                    "description": "The subscriber's click rate, or null when unavailable."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "raw": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "The raw Buttondown API object for advanced fields."
              }
            },
            "additionalProperties": true,
            "description": "A Buttondown subscriber."
          }
        },
        "additionalProperties": false,
        "required": [
          "subscriber"
        ],
        "description": "A Buttondown subscriber result."
      }
    },
    {
      "id": "buttondown.get_tag",
      "service": "buttondown",
      "name": "get_tag",
      "description": "Retrieve one Buttondown tag by ID.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "The Buttondown tag ID."
          }
        },
        "additionalProperties": false,
        "required": [
          "id"
        ],
        "description": "The tag lookup input."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "tag": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "A Buttondown tag."
          }
        },
        "additionalProperties": false,
        "required": [
          "tag"
        ],
        "description": "A Buttondown tag result."
      }
    },
    {
      "id": "buttondown.list_newsletters",
      "service": "buttondown",
      "name": "list_newsletters",
      "description": "List newsletters available to the Buttondown API key.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer",
            "minimum": 1,
            "description": "The 1-based page number of the paginated response."
          },
          "page_size": {
            "type": "integer",
            "minimum": 1,
            "maximum": 1000,
            "description": "The number of results per page."
          }
        },
        "additionalProperties": false,
        "description": "Pagination controls for a Buttondown list request."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "newsletters": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "A unique TypeID associated with the newsletter."
                },
                "creation_date": {
                  "type": "string",
                  "description": "The date and time at which the newsletter was first created.",
                  "format": "date-time"
                },
                "username": {
                  "type": "string",
                  "description": "The newsletter username, when returned by Buttondown."
                },
                "name": {
                  "type": "string",
                  "description": "The newsletter name, when returned by Buttondown."
                },
                "description": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "The newsletter description, when returned by Buttondown."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "raw": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": true,
                  "description": "The raw Buttondown API object for advanced fields."
                }
              },
              "additionalProperties": true,
              "description": "A Buttondown newsletter."
            },
            "description": "The newsletters returned for this page."
          },
          "page": {
            "type": "object",
            "properties": {
              "count": {
                "type": "integer",
                "description": "The total number of results across all pages."
              },
              "next": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "The URL to the next page of results, or null when there is no next page."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "previous": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "The URL to the previous page of results, or null when there is no previous page."
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": false,
            "required": [
              "count"
            ],
            "description": "Pagination metadata returned by Buttondown."
          }
        },
        "additionalProperties": false,
        "required": [
          "newsletters",
          "page"
        ],
        "description": "A paginated Buttondown newsletter list."
      }
    },
    {
      "id": "buttondown.list_subscribers",
      "service": "buttondown",
      "name": "list_subscribers",
      "description": "List Buttondown subscribers with common filters.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer",
            "minimum": 1,
            "description": "The 1-based page number of the paginated response."
          },
          "email_address": {
            "type": "string",
            "minLength": 1,
            "description": "Only return subscribers matching this email fragment."
          },
          "type": {
            "type": "string",
            "enum": [
              "regular",
              "premium",
              "unactivated",
              "unsubscribed",
              "removed"
            ],
            "description": "The subscriber lifecycle state returned by Buttondown."
          },
          "tag": {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1
            },
            "description": "Only return subscribers matching the given tag names.",
            "minItems": 1
          },
          "date__start": {
            "type": "string",
            "description": "Only return subscribers created on or after the given date.",
            "format": "date"
          },
          "date__end": {
            "type": "string",
            "description": "Only return subscribers created before the given date.",
            "format": "date"
          }
        },
        "additionalProperties": false,
        "description": "Filters and pagination controls for listing Buttondown subscribers."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "subscribers": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "A unique TypeID associated with the subscriber."
                },
                "creation_date": {
                  "type": "string",
                  "description": "The date and time at which the subscriber was first created.",
                  "format": "date-time"
                },
                "email_address": {
                  "type": "string",
                  "description": "The email address of the subscriber.",
                  "format": "email"
                },
                "type": {
                  "anyOf": [
                    {
                      "type": "string",
                      "enum": [
                        "regular",
                        "premium",
                        "unactivated",
                        "unsubscribed",
                        "removed"
                      ],
                      "description": "The subscriber lifecycle state returned by Buttondown."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "notes": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "Private notes attached to the subscriber."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "metadata": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": true,
                  "description": "A structured key-value blob stored on the Buttondown object."
                },
                "tags": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "minLength": 1
                  },
                  "description": "Tag names applied to the subscriber."
                },
                "avatar_url": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "URL of the subscriber's avatar image, if available."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "bounce_date": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "The date of the subscriber's most recent bounce event.",
                      "format": "date-time"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "churn_date": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "When the subscriber cancelled their paid subscription, if applicable.",
                      "format": "date-time"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "country": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "The ISO 3166-1 alpha-2 country code inferred at signup, if available."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "delivered_count": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "description": "The number of distinct emails delivered to this subscriber."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "open_count": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "description": "The subscriber's open count."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "clicked_count": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "description": "The subscriber's clicked count."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "open_rate": {
                  "anyOf": [
                    {
                      "type": "number",
                      "description": "The subscriber's open rate, or null when unavailable."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "click_rate": {
                  "anyOf": [
                    {
                      "type": "number",
                      "description": "The subscriber's click rate, or null when unavailable."
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "raw": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": true,
                  "description": "The raw Buttondown API object for advanced fields."
                }
              },
              "additionalProperties": true,
              "description": "A Buttondown subscriber."
            },
            "description": "The subscribers returned for this page."
          },
          "page": {
            "type": "object",
            "properties": {
              "count": {
                "type": "integer",
                "description": "The total number of results across all pages."
              },
              "next": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "The URL to the next page of results, or null when there is no next page."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "previous": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "The URL to the previous page of results, or null when there is no previous page."
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": false,
            "required": [
              "count"
            ],
            "description": "Pagination metadata returned by Buttondown."
          }
        },
        "additionalProperties": false,
        "required": [
          "subscribers",
          "page"
        ],
        "description": "A paginated Buttondown subscriber list."
      }
    },
    {
      "id": "buttondown.list_tags",
      "service": "buttondown",
      "name": "list_tags",
      "description": "List Buttondown tags.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer",
            "minimum": 1,
            "description": "The 1-based page number of the paginated response."
          },
          "page_size": {
            "type": "integer",
            "minimum": 1,
            "maximum": 1000,
            "description": "The number of results per page."
          }
        },
        "additionalProperties": false,
        "description": "Pagination controls for a Buttondown list request."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "tags": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {},
              "additionalProperties": true,
              "description": "A Buttondown tag."
            },
            "description": "The tags returned for this page."
          },
          "page": {
            "type": "object",
            "properties": {
              "count": {
                "type": "integer",
                "description": "The total number of results across all pages."
              },
              "next": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "The URL to the next page of results, or null when there is no next page."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "previous": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "The URL to the previous page of results, or null when there is no previous page."
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": false,
            "required": [
              "count"
            ],
            "description": "Pagination metadata returned by Buttondown."
          }
        },
        "additionalProperties": false,
        "required": [
          "tags",
          "page"
        ],
        "description": "A paginated Buttondown tag list."
      }
    },
    {
      "id": "buttondown.update_subscriber",
      "service": "buttondown",
      "name": "update_subscriber",
      "description": "Update a Buttondown subscriber by ID or email address.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "id_or_email": {
            "type": "string",
            "minLength": 1,
            "description": "The Buttondown subscriber ID or email address."
          },
          "commenting_disabled": {
            "anyOf": [
              {
                "type": "boolean",
                "description": "Whether this subscriber is prevented from commenting."
              },
              {
                "type": "null"
              }
            ]
          },
          "email_address": {
            "anyOf": [
              {
                "type": "string",
                "description": "The updated email address of the subscriber.",
                "format": "email"
              },
              {
                "type": "null"
              }
            ]
          },
          "notes": {
            "anyOf": [
              {
                "type": "string",
                "description": "Updated private notes to attach to the subscriber."
              },
              {
                "type": "null"
              }
            ]
          },
          "metadata": {
            "anyOf": [
              {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "A structured key-value blob stored on the Buttondown object."
              },
              {
                "type": "null"
              }
            ]
          },
          "tags": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "description": "A tag name."
                },
                "description": "Tag names to apply to the subscriber."
              },
              {
                "type": "null"
              }
            ]
          },
          "referrer_url": {
            "anyOf": [
              {
                "type": "string",
                "description": "The URL the subscriber was referred from."
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "regular",
                  "premium",
                  "unactivated",
                  "unsubscribed",
                  "removed"
                ],
                "description": "The subscriber lifecycle state returned by Buttondown."
              },
              {
                "type": "null"
              }
            ]
          },
          "unsubscription_reason": {
            "anyOf": [
              {
                "type": "string",
                "description": "Free-text reason the subscriber unsubscribed."
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "additionalProperties": false,
        "required": [
          "id_or_email"
        ],
        "description": "The request payload for updating a Buttondown subscriber."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "subscriber": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "A unique TypeID associated with the subscriber."
              },
              "creation_date": {
                "type": "string",
                "description": "The date and time at which the subscriber was first created.",
                "format": "date-time"
              },
              "email_address": {
                "type": "string",
                "description": "The email address of the subscriber.",
                "format": "email"
              },
              "type": {
                "anyOf": [
                  {
                    "type": "string",
                    "enum": [
                      "regular",
                      "premium",
                      "unactivated",
                      "unsubscribed",
                      "removed"
                    ],
                    "description": "The subscriber lifecycle state returned by Buttondown."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "notes": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Private notes attached to the subscriber."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "metadata": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "A structured key-value blob stored on the Buttondown object."
              },
              "tags": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1
                },
                "description": "Tag names applied to the subscriber."
              },
              "avatar_url": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "URL of the subscriber's avatar image, if available."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "bounce_date": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "The date of the subscriber's most recent bounce event.",
                    "format": "date-time"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "churn_date": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "When the subscriber cancelled their paid subscription, if applicable.",
                    "format": "date-time"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "country": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "The ISO 3166-1 alpha-2 country code inferred at signup, if available."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "delivered_count": {
                "anyOf": [
                  {
                    "type": "integer",
                    "description": "The number of distinct emails delivered to this subscriber."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "open_count": {
                "anyOf": [
                  {
                    "type": "integer",
                    "description": "The subscriber's open count."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "clicked_count": {
                "anyOf": [
                  {
                    "type": "integer",
                    "description": "The subscriber's clicked count."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "open_rate": {
                "anyOf": [
                  {
                    "type": "number",
                    "description": "The subscriber's open rate, or null when unavailable."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "click_rate": {
                "anyOf": [
                  {
                    "type": "number",
                    "description": "The subscriber's click rate, or null when unavailable."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "raw": {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "The raw Buttondown API object for advanced fields."
              }
            },
            "additionalProperties": true,
            "description": "A Buttondown subscriber."
          }
        },
        "additionalProperties": false,
        "required": [
          "subscriber"
        ],
        "description": "A Buttondown subscriber result."
      }
    },
    {
      "id": "buttondown.update_tag",
      "service": "buttondown",
      "name": "update_tag",
      "description": "Update a Buttondown tag by ID.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "The Buttondown tag ID."
          },
          "name": {
            "anyOf": [
              {
                "type": "string",
                "description": "The updated name of the tag."
              },
              {
                "type": "null"
              }
            ]
          },
          "color": {
            "anyOf": [
              {
                "type": "string",
                "description": "The updated hex color code associated with the tag."
              },
              {
                "type": "null"
              }
            ]
          },
          "description": {
            "anyOf": [
              {
                "type": "string",
                "description": "The updated internal description of the tag."
              },
              {
                "type": "null"
              }
            ]
          },
          "public_description": {
            "anyOf": [
              {
                "type": "string",
                "description": "The updated public-facing description of the tag."
              },
              {
                "type": "null"
              }
            ]
          },
          "secondary_id": {
            "anyOf": [
              {
                "type": "integer",
                "description": "The updated secondary human-readable numeric identifier."
              },
              {
                "type": "null"
              }
            ]
          },
          "subscriber_editable": {
            "anyOf": [
              {
                "type": "boolean",
                "description": "Whether subscribers can add or remove this tag from their own profile."
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "additionalProperties": false,
        "required": [
          "id"
        ],
        "description": "The request payload for updating a Buttondown tag."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "tag": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "A Buttondown tag."
          }
        },
        "additionalProperties": false,
        "required": [
          "tag"
        ],
        "description": "A Buttondown tag result."
      }
    }
  ]
}