This is a test message, delivered with <3 by Helo.
", text: "This is a test message, delivered with <3 by Helo.", template: {}, tracking: {}, attachments: [Helo::Attachment.new(content: "test-content", content_id: "test-contentId", content_type: "test-contentType", file_name: "test-fileName", disposition: Helo::AttachmentDisposition::ATTACHMENT)], tags: ["welcome", "onboarding"], headers: {}, metadata: {} ) Helo::Sending.transactional(send_message_request, channel_id: "550e8400-e29b-41d4-a716-446655440000", idempotency_key: "example") - lang: javascript source: |- import Helo from "@helo-email/sdk"; const apiKey = process.env.HELO_API_KEY; const helo = new Helo(apiKey); const result = await helo.sending.transactional( { from: { email: "from@yourdomain.com", name: "From name" }, to: [{ email: "to@example.com", name: "To name" }], cc: [{ email: "cc@example.com", name: "Cc name" }], bcc: [{ email: "bcc@example.com", name: "Bcc name" }], replyTo: [{ email: "reply-to@example.com", name: "Reply-To name" }], subject: "Hello from Helo", html: "This is a test message, delivered with <3 by Helo.
", text: "This is a test message, delivered with <3 by Helo.", template: { subject: "test-subject", html: "test-html", text: "test-text", inlineStyles: true, data: {}, }, tracking: { opens: true, links: true }, attachments: [ { content: "test-content", contentId: "test-contentId", contentType: "test-contentType", fileName: "test-fileName", disposition: Helo.AttachmentDisposition.ATTACHMENT, }, ], tags: ["welcome", "onboarding"], headers: {}, metadata: {}, }, { channelId: "550e8400-e29b-41d4-a716-446655440000", idempotencyKey: "example", }, ); - lang: go source: "package main\n\nimport (\n\t\"context\"\n\t\"log\"\n\t\"os\"\n\n\t\"github.com/helo-email/helo-sdk-go\"\n)\n\nfunc main() {\n\tclient := helo.NewHelo(os.Getenv(\"HELO_API_KEY\"))\n\tctx := context.Background()\n\n\tparams := &helo.SendMessageRequest{\n\t\tFrom: helo.MailAddress{Email: \"from@yourdomain.com\", Name: \"From name\"},\n\t\tTo: []helo.MailAddress{{Email: \"to@example.com\", Name: \"To name\"}},\n\t\tSubject: \"Hello from Helo\",\n\t\tHtml: \"This is a test message, delivered with <3 by Helo.
\",\n\t\tText: \"This is a test message, delivered with <3 by Helo.\",\n\t\tTags: []string{\"welcome\", \"onboarding\"},\n\t}\n\topts := &helo.SendingTransactionalOptions{\n\t\tChannelID: \"550e8400-e29b-41d4-a716-446655440000\",\n\t\tIdempotencyKey: \"example\",\n\t}\n\tresult, err := client.Sending.Transactional(ctx, params, opts)\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\t_ = result\n}" - lang: csharp source: >- using HeloEmail.Sdk; using HeloEmail.Sdk.Sending; var response = await helo.Sending.Transactional(new SendMessageRequest { From = new MailAddress { Email = "from@yourdomain.com", Name = "Sender" }, To = [new MailAddress { Email = "to@example.com" }], Subject = "Hello from Helo", Html = "This is a test message, delivered with <3 by Helo.
", Text = "This is a test message, delivered with <3 by Helo.", Tags = ["welcome", "onboarding"], }, channelId: "your-channel-id"); - lang: python source: |- import sdk_helo_email as helo client = helo.Helo() # reads HELO_API_KEY from the environment response = client.sending.transactional( from_={"email": "from@yourdomain.com", "name": "From name"}, to=[{"email": "to@example.com"}], subject="Hello from Helo", html="This is a test message, delivered with <3 by Helo.
", text="This is a test message, delivered with <3 by Helo.", tags=["welcome", "onboarding"], channel_id="your-channel-id", ) components: schemas: SendMessageRequest: type: object properties: from: $ref: '#/components/schemas/MailAddress' to: type: array items: $ref: '#/components/schemas/MailAddress' cc: type: array items: $ref: '#/components/schemas/MailAddress' bcc: type: array items: $ref: '#/components/schemas/MailAddress' replyTo: type: array items: $ref: '#/components/schemas/MailAddress' subject: type: string html: type: string text: type: string template: type: object properties: subject: type: string html: type: string text: type: string inlineStyles: type: boolean data: type: object description: Model used for template placeholder replacement tracking: type: object properties: opens: type: boolean links: type: boolean attachments: type: array items: $ref: '#/components/schemas/Attachment' tags: type: array items: type: string headers: type: object metadata: type: object required: - from - to SendMessageAcceptedResponse: type: object properties: status: type: string messageId: type: string format: uuid suppressions: type: array items: type: string MailAddress: type: object properties: email: type: string description: Email address. Max 254 characters. name: type: string description: Display name shown to recipients in their email client. required: - email Attachment: type: object properties: content: type: string format: byte description: Base64-encoded file content. contentId: type: string description: >- Used to reference inline images in HTML (e.g. `cid:logo`). Only applicable when `disposition` is `inline`. contentType: type: string description: >- MIME type (e.g. `application/pdf`). Inferred from the file extension if not provided. fileName: type: string description: >- File name including extension (e.g. `report.pdf`). Executable and potentially harmful file types are blocked. disposition: $ref: '#/components/schemas/AttachmentDisposition' required: - content - fileName - disposition ErrorResponse: description: Standard error response body. type: object properties: type: description: A URI reference identifying the problem type. type: string title: description: Short, human-readable summary of the problem. type: string instance: description: URI reference identifying the specific occurrence of the problem. type: string status: description: HTTP status code. type: integer format: int32 code: description: Application-specific error code. type: string detail: description: Human-readable explanation of this specific occurrence. type: string requestId: description: Unique request ID, useful for support correlation. type: string errors: description: Field-level validation errors, keyed by field name. type: object additionalProperties: type: array items: $ref: '#/components/schemas/ValidationError' AttachmentDisposition: enum: - attachment - inline description: >- How the attachment is presented. Use `attachment` for downloadable files and `inline` for embedded content (e.g. images referenced in HTML). ValidationError: description: A single field validation error. required: - message type: object properties: message: description: Description of the validation failure. type: string responses: '401': description: Unauthorized '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '422': description: Unprocessable Entity content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````