# Send 100 emails in one API call

A batch is an array of complete email sends in a single request — every item its own recipient, subject, content, and template parameters. In this video we send a batch with a deliberate mistake in it and watch Bird reject the whole thing before anything queues, then fix one line and get an ID back for every message.

Video: https://www.youtube.com/watch?v=ag6YEO8hq9g (2:36)

## What we cover

- Sending up to 1,000 emails in a single API call
- Personalizing every message in the batch
- Reading the per-recipient result

## Transcript

_Auto-generated from the video._

Hey, and welcome to another video. Um, today I'm going to be talking about batch sending. Um, so the difference between broadcast, which we covered in a different video, and batch sending is a broadcast is a predefined group email that you're going to be sending to a lot of recipients at the same time. Whereas a batch send basically allows you to send a pile of emails that you've already had to just be submitted through a single API call. So these are usually group uh a bunch of emails that you've already set up. These can be notifications, they can be OTP verification emails, they can be marketing emails, that doesn't matter cuz these are all individual sends with their own uh sender, their own recipient, their own subject, and their own template.

Um, so what I've got here is just a documentation, again, bird.com/docs. All of our documentation is updated on a uh on a regular basis, enabling you to always have the full overview. Um, when we scroll down to batch sends, here we can actually see that there's nothing more than just batching your emails together. It's good to note that this can be done up to 100 emails within a single batch, and this allows you to lower the amount of API calls that you would need to make. So instead of sending an API call for every single email that needs to be sent out, you can actually batch them together in groups of 100 to make it more um more carriable for the system.

Um, so as you can see here, so the only thing that's different is that we actually give them a batch key and that we're calling uh the batch API, but then the actual individual email sections are all still the same. So they've all got their own from, their own to, their unique subject, the actual email, and the specific category for that send. Now, I've opened up my terminal and I've already had a batch send ready with specific files saved on my computer.

Sending it out, we can see that the batch has been successfully sent. Now, here you can see that the batch returns the data per individual email. So we've got the full data point per individual email that we have been sending. Now, if we go back into our email logs and we refresh for the latest, we can actually see that the batch has gone out, but they're all sent as individual messages. Um so, we can see the complete details of the specific email event.

Um again, there's no reference back to that batch because it's in the essence just an individual email just getting submitted in a batch towards our system. That is batch sending in a nutshell. Um go and have a look, play around with it. And we say happy sending.

## More Email guides

- [Getting started with email](/de-de/learn/e-mail/email-setup) — 3:30
- [How to build an email template](/de-de/learn/e-mail/email-template) — 7:35
- [Schedule an email to send later](/de-de/learn/e-mail/email-schedule) — 2:28
- [Testing email without spamming anyone](/de-de/learn/e-mail/email-sandbox) — 4:40
- [What happens between send and the inbox](/de-de/learn/e-mail/email-to-inbox) — 2:11
- [What happens when someone opts out](/de-de/learn/e-mail/email-suppressions) — 3:55
- [Why your sending domain is throttled](/de-de/learn/e-mail/email-domain-throttled) — 3:24
- [Buying a dedicated IP](/de-de/learn/e-mail/email-dedicated-ip) — 3:30
- [Email broadcasts: one email to your whole audience](/de-de/learn/e-mail/email-broadcasts) — 8:08

## Resources

- [Documentation](/de-de/dokumentation)
- [Learn more about Email](/de-de/produkte/e-mail)