Create event

Effortlessly Create and Enhance Events in Minutes

Introduction

To create an event using our API, simply follow these two easy steps:

1. Create the event: Use our event creation function to specify event details such as name, date, and location. This function is user-friendly and designed to help you create your event in minutes.

2. Add images: Once you've created your event, you can enhance its visual appeal by adding images. Our API allows you to quickly and easily upload images via our image upload function.

1. Creating an event

Create the event

POST https://api.evently.live/v1/events

Required authentication*

Headers

Name	Type	Description
x-token*	String	Token required for secure access to transaction data

Request Body

Name	Type	Description
name*	string	The name of the event.
description*	string	A brief description of the event.
date*	date	The date when the event is taking place in the format YYYY-MM-DD.
time*	time	The start time of the event in the format HH:MM:SS.
address*	string	The address of the event venue.
place*	string	The name of the event venue.
city*	string	The city where the event is taking place.
province*	string	The province or state where the event is taking place.
country*	string	The country where the event is taking place.
end_date*	date	The end date of the event in the format YYYY-MM-DD.
entry_time*	time	The time when entry to the event begins in the format HH:MM:SS.
end_time*	time	The end date of the event in the format YYYY-MM-DD.
tags*	array	An array of tags associated with the event.
tickets_data*	array	An array containing information about the tickets available for the event.
tickets_data.ticket_name*	string	The name of the ticket type.
tickets_data.max_reselling_price*	integer	The maximum amount the ticket can be resold for.
tickets_data.price*	integer	The cost of the ticket.
tickets_data.area*	string	The location where the ticket holder will be situated.
tickets_data.ticket_description*	string	A brief description of the ticket type.
tickets_data.max_per_order*	integer	The maximum number of tickets that can be purchased per order.
tickets_data.quantity*	integer	The total number of tickets available for purchase.
royalties*	array	An array containing information about the royalties for the event.
royalties.name*	string	The name of the company receiving royalties.
royalties.porcent*	integer	The percentage of royalties being paid.
royalties.paymentPlace*	string	The URL of the payment platform.

200 Event successfully created

{
    "name"="Wilson",
    "owner": {
        "id": "sha7891bikojbkreuy",
        "name": "Samuel Passet",
    "species": "Dog",}
    "breed": "Golden Retriever",
}

401 Permission denied

400 Bad request

500: Internal Server Error Please contact to support

Examples:

https://api.evently.live/v1/events

Body:

{
    "name": "Michael Jackson",
    "description": "This event...",
    "address": "Brown 344",
    "place": "Bar Shevere",
    "country": "Argentina",
    "province": "Buenos Aires",
    "city": "Caba",
    "date": "2023-02-07",
    "end_date": "2023-02-07",
    "time": "20:15:00",
    "end_time": "20:15:00",
    "entry_time": "20:15:00",
    "tags": ["pop","rock"],
    "tickets_data": [
		{
        "ticket_name": "General",
        "ticket_description": "General...",
	"area": "General",
        "price": 15000,
        "quantity": 300,
        "max_per_order": 5,
        "max_reselling_price": 2333
    },
		{
        "ticket_name": "VIP",
        "ticket_description": "VIP...",
	"area": "VIP",
        "price": 18000,
        "quantity": 300,
        "max_per_order": 5,
        "max_reselling_price": 2333
    }
	],
    "royalties": [{
		"name":"Adidas",
		"porcent": 15,
		"paymentPlace":"https//royalties.io/path"
	}]
}

Returns

{
	"msg": "Event created",
	"event": {
		"tags": [ "pop", "rock" ],
		"createdAt": "2022-03-07 10:09:27",
		"id": "29b6d4ff-6b3e-4592-95a8-6c0a4eq08c93",
		"condition": "active",
		"status": true,
		"remote": "presencial",
		"category": "Concert",
		"pk": 35,
		"name": "Michael Jackson",
		"description": "description event...",
		"creator_id": 5
	},
	"ticket": {
		"id": "76188f54-6742-4146-9379-82b55f56817f",
		"status": true,
		"pk": 30,
		"name": "General",
		"description": "Brief description",
		"date": "2023-02-07",
		"entry_time": "20:15:00",
		"end_date": "2023-02-07",
		"end_time": "20:15:00",
		"time": "20:15:00",
		"address": "Brown 344",
		"place": "Bar Shevere",
		"province": "Buenos Aires",
		"city": "Caba",
		"country": "Argentina",
		"event_id": 35
	},
	"royalties": [
		{
		  "name": "Adidas",
		  "porcent": 15,
		"paymentPlace": "http:?mvjreijnvier"
		}
	]
}

2. Uploading images

Warning: You can only add images to events that have already been created.

Important: To ensure proper processing of your request, please note that it must be submitted in the correct format as form data. Any requests sent in a different format may not be processed correctly.

Upload images

POST https://api.evently.live/v1/events/uploads/{event_id}

Required authentication*

Path Parameters

Name	Type	Description
event_id*	string	Unique identifier of the event for which the files are being uploaded.

Headers

Name	Type	Description
x-token*	String	Token generated after login
Content-Type*	String	multipart/form-data

Request Body

Name	Type	Description
flyer_image*	file	The flyer image file to be uploaded.
cover_image*	file	The cover image file to be uploaded.
frame_preview1*	file	The first preview image file to be uploaded.
frame_preview2*	file	The second preview image file to be uploaded.
video	file	Video file to upload.

200 OK

{
    "name"="Wilson",
    "owner": {
        "id": "sha7891bikojbkreuy",
        "name": "Samuel Passet",
    "species": "Dog",}
    "breed": "Golden Retriever",
}

401 Permission denied

400 Bad request

500: Internal Server Error Please contact to support

Examples:

https://api.evently.live/v1/events/uploads/{event_id}

Code in Express.js using Axios

const axios = require('axios');
const FormData = require('form-data');
const fs = require('fs');

const formData = new FormData();
formData.append('flyer_image', fs.createReadStream('path/to/file'));
formData.append('cover_image', fs.createReadStream('path/to/file'));
formData.append('frame_preview1', fs.createReadStream('path/to/file'));
formData.append('frame_preview2', fs.createReadStream('path/to/file'));
formData.append('video', fs.createReadStream('/path/to/file'));

axios.post('https://api.evently.live/v1/events/uploads/{event_id}', formData, {
    headers: {
        'Content-Type': 'multipart/form-data'
    }
})
    .then((response) => {
        console.log(response.data);
    })
    .catch((error) => {
        console.error(error.request);
    });
ava

Returns

{
	"event": {
		"tags": ["pop","rock"],
		"pk": 1,
		"id": "649322ff-fg32-489c-9535-623931151cc6",
		"name": "Casino",
		"description": "Description ...",
		"cover_image": "https://evently-img.s3.amazonaws.com/events/CXcF8d6oC26qO",
		"flyer_image": "https://evently-img.s3.amazonaws.com/events/DiEXKH7UIFMs",
		"video": "https://evently-img.s3.amazonaws.com/events/DFIimYoHHGwZzb",
		"condition": "active",
		"status": true,
		"remote": "presencial",
		"category": "no category",
		"createdAt": "2023-03-07T10:09:27.000Z",
		"creator_id": 1
	},
	"tickets": [
		{
		  "pk": 1,
		  "id": "b7664410-b4ce-4d2b-88cd-689202dg50d6",
		  "area": "General",
		  "price": 15000,
		  "available": 300,
		  "frame_preview": "https://evently-img.s3.amazonaws.com/events/CanoNu7kma5k1X4T",
		  "max_per_order": 5,
		  "max_reselling_price": 2333,
	          "isResale": false,
		  "isTransfer": false,
		  "addCollectable": false,
		  "status": true,
	          "ticket_id": 1
		},
		{
		  "pk": 2,
		  "id": "df4d269d-b9e7-4a16-89da-f022e028d47a",
		  "area": "casita",
		  "price": 18000,
		  "available": 300,
		  "frame_preview": "https://evently-img.s3.amazonaws.com/events/iosXcPEWQ8KUNI",
		  "max_per_order": 5,
		  "max_reselling_price": 2333,
		  "isResale": false,
		  "isTransfer": false,
		  "addCollectable": false,
		  "status": true,
		  "ticket_id": 1
		}
	]
}

Good to know: These two simple steps will help you create a complete event ready to share with your clients or followers. Feel free to contact us if you need assistance with either of these steps or have any questions about our API. We're here to help you succeed with your events and projects.