> Portal Navigation: > > - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version. > - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages). > - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`). > - Top-level index of all portals: https://dev.wix.com/docs/llms.txt > - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt # AssignEvents # Package: eventManagement # Namespace: CategoryManagement # Method link: https://dev.wix.com/docs/api-reference/business-solutions/events/event-management/categories/assign-events.md ## Permission Scopes: Manage Events - all permissions: SCOPE.DC-EVENTS-MEGA.MANAGE-EVENTS ## Introduction Assigns events to a single category. --- ## REST API ### Schema ``` Method: assignEvents Description: Assigns events to a single category. URL: https://www.wixapis.com/events/v1/categories/{categoryId}/events Method: POST # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present. Required parameters: eventId Method parameters: param name: eventId | type: array | description: A list of events GUIDs. | required: true Return type: AssignEventsResponse EMPTY-OBJECT {} ``` ### Examples ### AssignEvents ```curl ~~~cURL curl -X POST 'https://www.wixapis.com/events/v1/categories/e9779de3-a085-4255-b3a6-9559990d4436/events' \ -H 'Content-Type: application/json' \ -H 'Authorization: ' \ -d '{ "categoryId": "e9779de3-a085-4255-b3a6-9559990d4436", "eventId": [ "539a564e-48d2-4eac-8e14-d7a91be6b1c2", "abd39eb7-844c-4321-9ea2-0d43040be05e" ] }' ~~~ ``` --- ## JavaScript SDK ### Schema ``` Method: wixClientAdmin.eventManagement.CategoryManagement.assignEvents(categoryId, eventId) Description: Assigns events to a single category. # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present. Required parameters: categoryId, eventId Method parameters: param name: categoryId | type: string | description: GUID of category to which events should be assigned. | required: true param name: eventId | type: array | description: A list of events GUIDs. | required: true Return type: PROMISE EMPTY-OBJECT {} ``` ### Examples ### Assign events to a category (with elevated permissions) ```javascript import { categories } from '@wix/events'; import { auth } from '@wix/essentials'; const elevatedAssignEvents = auth.elevate(categories.assignEvents); /* * Sample value of categoryId: "6ec293a8-1b47-4337-9c4e-9a6aeb35e66a", * Sample value of eventId: ["4e5e4adb-9778-4171-a9bb-44e27834ac89"] */ export async function myAssignEventsFunction(categoryId, eventId) { try { const assignedEvents = await elevatedAssignEvents(categoryId, eventId); console.log('Events are assigned to the category'); return assignedEvents; } catch (error) { console.error(error); // Handle the error } } /* Promise resolves to void */ ``` ### Assign events to a category ```javascript import { categories } from '@wix/events'; /* * Sample value of categoryId: "6ec293a8-1b47-4337-9c4e-9a6aeb35e66a", * Sample value of eventId: ["4e5e4adb-9778-4171-a9bb-44e27834ac89"] */ export async function myAssignEventsFunction(categoryId, eventId) { try { const assignedEvents = await categories.assignEvents(categoryId, eventId); console.log('Events are assigned to the category'); return assignedEvents; } catch (error) { console.error(error); // Handle the error } } /* Promise resolves to void */ ``` ### assignEvents (self-hosted) Self-hosted SDK calls require you to [create a client](https://dev.wix.com/docs/sdk/articles/work-with-the-sdk/about-the-wix-client.md). ```javascript import { createClient } from '@wix/sdk'; import { categories } from '@wix/events'; // Import the auth strategy for the relevant access type // Import the relevant host module if needed const myWixClient = createClient ({ modules: { categories }, // Include the auth strategy and host as relevant }); async function assignEvents(categoryId,eventId) { const response = await myWixClient.categories.assignEvents(categoryId,eventId); }; ``` ---