You want to create and send a bulletin in one action using the API. This can only be done for one bulletin at a time. You can specify content for the bulletin using a multipart form if you need to include file attachments for the bulletin. If no attachments are required, you can also use XML for the input.

When you POST to the bulletin resource, a bulletin is created in draft status. Using this method, you specify bulletin content, including a header, footer, and body as well as sending options, like pushing to RSS and tracking recipient interactions with the bulletin. This draft bulletin can be viewed and sent via the administrative interface.

You can update a bulletin in draft form by sending a PUT operation for a particular bulletin ID. In order to do this, you need the ID of the bulletin. This is returned by the Create Draft Bulletin method. You can also use the List Draft Bulletins method to see what bulletins currently exist in draft form and get a draft bulletin's ID.

You can send existing bulletins in draft form by sending a POST operation for a particular bulletin ID using the send_now link. In order to do this, you need the ID of the bulletin. This is returned by the Create Draft Bulletin method. You can also use the List Draft Bulletins method to see what bulletins currently exist in draft form and get a draft bulletin's ID.

If you are using the API to create and send bulletins, without holding them in draft form for review or any other reason, consider using the Create and Send Bulletin method.

Before sending a bulletin to your subscribers, it's a good idea to test it. You can do so by sending a test of the bulletin to a list of internal recipients for review.

You can schedule a bulletin still in draft form to be sent at a later time and date. This method activates the schedule. The date and time are set when you initially create the bulletin or can be set using the Update Bulletin method.

You can unschedule a scheduled bulletin that has not yet been sent. After unscheduling, the bulletin will be in draft form and can be found using the List Draft Bulletins method.

You can delete a bulletin still while it's in draft form. You can find all bulletins in draft form for your account using the List Draft Bulletins method.

You can look up all bulletins currently in draft form for your account using a GET operation. This call returns information about the bulletin like the subject, metadata (who created it, when it was sent, etc.), and the URI for that specific bulletin. You can use the returned URI for additional operations, like sending a bulletin, updating a bulletin attachment, or scheduling a bulletin.

You can add attachments to any bulletin still in draft form. In order to make this call, you will need the bulletin's ID. You can find all bulletins that are currently in draft form for your account (and get their ID) using the List Draft Bulletins method. For this call, the input is multipart and we recommend using a library to construct the MIME content.

You can remove an attachment from any bulletin that has not been delivered. If you remove an attachment from a bulletin that has already been sent, the attachment will only be removed for those recipients whose bulletin messages are still queued for sending.

You can update an attachment for a bulletin that has not been delivered. If you update an attachment for a bulletin that has already been sent, the attachment will only be updated for those recipients whose bulletin messages are still queued for sending. Note that you can't change a bulletin using this call; you can only update the same bulletin (replacing the old version with the new version). If you want to change a bulletin attachment, use the Remove a Bulletin method, followed by Add a Bulletin.