Record Participants by Email
POST {{baseUrl}}/marketing/v3/marketing-events/:objectId/attendance/:subscriberState/email-create
Records the participation of multiple HubSpot contacts in a Marketing Event using their email addresses.
If a contact does not exist, it will be automatically created. The contactProperties field is used exclusively for creating new contacts and will not update properties of existing contacts.
Additional Functionality: - Adds a timeline event to the contacts.
Allowed Properties:
For the state attend
:
- joinedAt
- leftAt
Request Body
{"inputs"=>[{"email"=>"<string>", "interactionDateTime"=>"<long>", "contactProperties"=>{"eu6"=>"<string>"}, "properties"=>{"nostrudf0"=>"<string>"}}, {"email"=>"<string>", "interactionDateTime"=>"<long>", "contactProperties"=>{"id_c1a"=>"<string>"}, "properties"=>{"cupidatat_a"=>"<string>"}}]}
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Content-Type | string | ||
Accept | string |
RESPONSES
status: OK
{"completedAt":"1991-04-25T22:37:06.614Z","results":[{"email":"et incididunt commodo reprehenderit","vid":-93190574},{"email":"dolore aliquip et in","vid":42263716}],"startedAt":"1945-04-19T07:34:28.696Z","status":"CANCELED","numErrors":97462129,"requestedAt":"1986-02-06T01:58:39.245Z","links":{"exercitation__55":"dolor officia consectetur","mollit_589":"dolore ut sunt minim"},"errors":[{"category":"veniam consectetur ","context":{"do_ca":["in eiusmod l","ipsum consequat id esse"]},"errors":[{"message":"ex non","subCategory":"aliqua Ut","code":"ut sunt eiusmod dolore a","in":"elit sunt dolor","context":{"adipisicing19f":["tempor in eiusmod","ullamco amet aute ipsum consequat"]}},{"message":"in officia","subCategory":"exercitation cupidatat amet","code":"dolore magna","in":"n","context":{"esse1":["elit s","id ex et occaecat"]}}],"links":{"Lorem11":"consequat aliquip cillum proident occaecat"},"message":"ipsum","status":"in Duis qui in","subCategory":{},"id":"Duis"},{"category":"eu dolor culpa sunt eiusmod","context":{"culpa56":["Duis qui amet anim","commodo aliquip ipsum"],"officia4_":["exercitation dolor","ut Lorem aute sit"]},"errors":[{"message":"irure deserunt dolore","subCategory":"aliquip","code":"ut","in":"anim Lorem","context":{"amet_e":["nostrud Lorem in","voluptate laborum in"],"ut7_c":["labore nisi pariatur Lorem","aliquip sint"]}},{"message":"aute culpa eu","subCategory":"ut Ut non est laborum","code":"do tempor velit","in":"sin","context":{"laborum65":["laboris","nisi"],"officia_55":["in","dolore in"]}}],"links":{"consequat_28":"qui culpa","minim6":"dolor ullamco commodo","Lorem_f":"sint anim sit"},"message":"quis deserunt nulla dolore eu","status":"eu cillum reprehenderit anim","subCategory":{},"id":"eiusmod sint esse dolor exercitation"}]}