---
title: "הוספת אורחים בכמויות דרך ה-API"
description: "תדחפו אורחים מגיליון או מ-CRM, עד 100 בכל קריאה, עם תוצאה לכל אחד."
canonical: https://app.ueventi.com/docs/he/articles/add-guests-in-bulk-with-the-api
last_updated: 2026-10-14
language: he
collection: "API ואינטגרציות"
---

# הוספת אורחים בכמויות דרך ה-API

תדחפו אורחים מגיליון או מ-CRM, עד 100 בכל קריאה, עם תוצאה לכל אחד.

כל הנושאים: [API ואינטגרציות](https://app.ueventi.com/docs/he/api-and-integrations)

כדי להוסיף אורחים ממערכת אחרת, תשלחו אותם ל-**POST https://api.ueventi.com/v1/events/{id}/guests/batch** עם מפתח שיש לו הרשאת **הוספת אורחים**. את מזהה האירוע תיקחו מרשימת האירועים.

הגוף הוא אובייקט JSON עם רשימת **guests** של עד 100 רשומות ו-**"consent": true**. כל אורח צריך **name** ו-**phone** עם קידומת המדינה. **language**,‏ **party_size_invited**,‏ **side**,‏ **group** ו-**custom_link** הם רשות, בדיוק כמו בדשבורד.

## מה חוזר

בתשובה יש תוצאה אחת לכל אורח, באותו סדר ששלחתם. לכל תוצאה יש **status**: **201** אומר שנוצר (הגוף הוא האורח החדש עם קישור ההזמנה האישי שלו), **400** אומר שהשורה לא תקינה (הגוף מפרט אילו שדות), **409** אומר שאורח עם הטלפון הזה כבר נמצא באירוע. הקריאה מצליחה גם אם חלק מהשורות נכשלו, אז תבדקו כל תוצאה.

- כדי להוסיף אורח אחד, תשתמשו ב-**POST /v1/events/{id}/guests** עם אותם שדות ועם **consent**.
- מספרי טלפון מנורמלים לפורמט בינלאומי, אז **+972 50-123-4567** ו-**+972501234567** הם אותו אורח.
- רשימות גדולות יותר נשלחות בכמה קבוצות של 100. תשלחו כותרת **Idempotency-Key** בכל קריאה, כך שניסיון חוזר אחרי timeout אף פעם לא ייצור כפילויות.

## הסכמה

השדה **consent** הוא אותו אישור שאתם נותנים כשמייבאים בדשבורד: אתם מאשרים שהאורחים האלה הסכימו לקבל מכם הזמנות ותזכורות. בלעדיו הבקשה נדחית ושום דבר לא נכתב. ראו [הסכמת האורחים](https://app.ueventi.com/docs/he/articles/guest-consent).

> **Note:** הוספת אורח דרך ה-API לא שולחת שום דבר. ההודעות יוצאות לפי המסע של האירוע, בדיוק כמו לאורחים שנוספו בדשבורד.

## מאמרים קשורים

- [יצירת מפתח API](https://app.ueventi.com/docs/he/articles/create-an-api-key.md): תיצרו מפתח לסקריפט או לסוכן AI, תבחרו מה מותר לו לעשות ותשמרו עליו.
- [הבקשה הראשונה והסנדבוקס](https://app.ueventi.com/docs/he/articles/your-first-request-and-the-sandbox.md): תנסו את ה-API בלי מפתח בסנדבוקס, ואז תשלחו בקשה אמיתית עם המפתח שלכם.
- [ייצוא אישורי הגעה דרך ה-API](https://app.ueventi.com/docs/he/articles/export-rsvps-with-the-api.md): תורידו את רשימת האורחים עם התשובות כקובץ CSV, מוכן למפיקה או לגיליון.