Saltar al contingut principal
PUT

Actualitzar un esdeveniment

Scope:crm:events.write
https://api.holded.com/api/v2/events/{eventId}

Actualitza les dades d'un esdeveniment de calendari existent.

Paràmetres

Paràmetres de ruta

eventIdstringobligatori

ID de l'esdeveniment (ObjectId hexadecimal de 24 caràcters)

Cos de la petició

object
namestring

Nom de l'esdeveniment

user_idstring | null

Identificador de l'usuari propietari

contact_idstring | null

Identificador del contacte associat

contact_namestring | null

Nom del contacte per mostrar

kindstring | null

Tipus d'activitat (p. ex. call, meeting, email)

descriptionstring | null

Descripció de l'esdeveniment

start_datestring<date-time>

Data i hora d'inici en format ISO 8601

end_datestring<date-time> | null

Data i hora de fi en format ISO 8601

durationinteger | null

Durada en segons (si no s'especifica end_date)

statusinteger | null

Estat de l'esdeveniment (0 = pendent, 1 = completat)

tags[]string[] | null

Llista d'etiquetes

lead_idstring | null

Identificador de l'oportunitat associada

locationstring | null

Ubicació de l'esdeveniment

participants[]object[] | null

Llista de participants/convidats a l'esdeveniment

emailstring<email>required

Correu electrònic del participant

namestring | nulloptional

Nom del participant

Petició

python
import requests

url = "https://api.holded.com/api/v2/events/{eventId}"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}

payload = {
    "name": "string",
    "user_id": "string",
    "contact_id": "string",
    "contact_name": "string",
    "kind": "string",
    "description": "string",
    "start_date": "2024-01-15T10:30:00Z",
    "end_date": "2024-01-15T10:30:00Z",
    "duration": 0,
    "status": 0,
    "tags": [
        "string"
    ],
    "lead_id": "string",
    "location": "string",
    "participants": [
        {
            "email": "user@example.com",
            "name": "string"
        }
    ]
}
response = requests.put(url, headers=headers, json=payload)
print(response.json())

Respostes

Resposta

json
{
  "id": "string"
}

Respostes exitoses

200Esdeveniment actualitzatapplication/json
object
idstring

Respostes d'error

400Sol·licitud incorrectaapplication/json
401API key no vàlida o no proporcionadaapplication/json
403Permisos insuficientsapplication/json
404Esdeveniment no trobatapplication/json
422Error de validacióapplication/json
429Límit de sol·licituds exceditapplication/json