uploadpersonalizedattachments
These attachments can be used when sending transactional mails. For more information regarding the Personalized Attachments feature, see Personalized Attachments - Examples.
This operation is available in the form service.
- Tips The Personalized Attachment feature must first be activated by customer support.
- Personalized Attachments can only be used for event mailings.
- Do not upload more than 500 kB at once.
- With each call of this operation, up to five files can be uploaded.
- An attachment is valid for 24 hours by default; i.e., after this time, the attachment can no longer be used for sending.
Parameters
Name | Mandatory | Default value | Description |
|---|---|---|---|
bmFile | yes | – | Defines the attachment to be uploaded This parameter may occur multiple times. I.e., multiple attachments (up to five) can be uploaded per call. |
Return values
Value | Description |
|---|---|
ok: <token> | The attachment has been successfully uploaded and can be used later using this returned token with the operation sendtransactionmail. A token is valid for 24 hours by default; i.e., after this time, the token becomes invalid and you must invoke the operation again. |
syntax_error: No files uploaded. | The value of the parameter bmfileis invalid. Check the spelling. |
syntax_error: Invalid file-parameter name <Parameter name> - must be 'bmFile'. | Instead of the parameter name bmFilean incorrect parameter name was used. Always use the parameter name bmfileto upload attachments. |
vetoed: Personalized attachments are not enabled. | The Personalized Attachments feature has not yet been activated. To activate the feature, contact customer support. |
file_upload_failed: Ask Campaign support for ticket #<ticket ID> | A general error occurred while uploading the attachment. Contact customer support and quote this ticket ID. |
wrong_tag | Authorization failed. Error codes:
|
Example
See Personalized Attachments - Examples for examples for Personalized Attachments.