get_subscriber_details
Retrieve detailed information about a specific subscriber, including their publication ID and subscriber ID, to analyze individual audience data in Beehiiv newsletter analytics.
Instructions
Get detailed information about a specific subscriber
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| publication_id | Yes | The ID of the publication | |
| subscriber_id | Yes | The ID of the subscriber |
Implementation Reference
- server.js:102-104 (handler)The handler function in BeehiivAPI class that performs the HTTP GET request to retrieve subscriber details from the Beehiiv API.
async getSubscriberDetails(publicationId, subscriberId) { return await makeRequest('GET', `${this.baseUrl}/publications/${publicationId}/subscribers/${subscriberId}`, this.headers); } - server.js:271-288 (schema)The input schema and metadata for the 'get_subscriber_details' tool, provided in the tools/list response.
{ name: "get_subscriber_details", description: "Get detailed information about a specific subscriber", inputSchema: { type: "object", properties: { publication_id: { type: "string", description: "The ID of the publication" }, subscriber_id: { type: "string", description: "The ID of the subscriber" } }, required: ["publication_id", "subscriber_id"] } }, - server.js:384-386 (registration)The dispatch logic in the tools/call handler that routes the tool invocation to the appropriate client method.
case 'get_subscriber_details': result = await client.getSubscriberDetails(args.publication_id, args.subscriber_id); break;