get_single_send
Retrieve details for a specific email campaign in SendGrid by providing its unique ID to access campaign information.
Instructions
Get details of a specific single send
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| single_send_id | Yes | ID of the single send to retrieve |
Implementation Reference
- src/tools/index.ts:524-537 (handler)Handler for the 'get_single_send' tool call. It invokes the SendGrid service to retrieve the single send by ID and returns a formatted JSON response with key details.case 'get_single_send': const retrievedSingleSend = await service.getSingleSend(args.single_send_id); return { content: [{ type: 'text', text: JSON.stringify({ id: retrievedSingleSend.id, name: retrievedSingleSend.name, status: retrievedSingleSend.status, send_at: retrievedSingleSend.send_at, list_ids: retrievedSingleSend.send_to.list_ids }, null, 2) }] };
- src/services/sendgrid.ts:286-292 (helper)Core service method that performs the actual API request to SendGrid to fetch details of a specific single send.async getSingleSend(singleSendId: string): Promise<SendGridSingleSend> { const [response] = await this.client.request({ method: 'GET', url: `/v3/marketing/singlesends/${singleSendId}` }); return response.body as SendGridSingleSend; }
- src/tools/index.ts:333-342 (schema)Input schema definition for the 'get_single_send' tool, specifying the required 'single_send_id' parameter.inputSchema: { type: 'object', properties: { single_send_id: { type: 'string', description: 'ID of the single send to retrieve' } }, required: ['single_send_id'] }
- src/tools/index.ts:330-343 (registration)Registration of the 'get_single_send' tool within the getToolDefinitions array, including name, description, and input schema.{ name: 'get_single_send', description: 'Get details of a specific single send', inputSchema: { type: 'object', properties: { single_send_id: { type: 'string', description: 'ID of the single send to retrieve' } }, required: ['single_send_id'] } },