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

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

RESPONSES

status: OK

{&quot;completedAt&quot;:&quot;1991-04-25T22:37:06.614Z&quot;,&quot;results&quot;:[{&quot;email&quot;:&quot;et incididunt commodo reprehenderit&quot;,&quot;vid&quot;:-93190574},{&quot;email&quot;:&quot;dolore aliquip et in&quot;,&quot;vid&quot;:42263716}],&quot;startedAt&quot;:&quot;1945-04-19T07:34:28.696Z&quot;,&quot;status&quot;:&quot;CANCELED&quot;,&quot;numErrors&quot;:97462129,&quot;requestedAt&quot;:&quot;1986-02-06T01:58:39.245Z&quot;,&quot;links&quot;:{&quot;exercitation__55&quot;:&quot;dolor officia consectetur&quot;,&quot;mollit_589&quot;:&quot;dolore ut sunt minim&quot;},&quot;errors&quot;:[{&quot;category&quot;:&quot;veniam consectetur &quot;,&quot;context&quot;:{&quot;do_ca&quot;:[&quot;in eiusmod l&quot;,&quot;ipsum consequat id esse&quot;]},&quot;errors&quot;:[{&quot;message&quot;:&quot;ex non&quot;,&quot;subCategory&quot;:&quot;aliqua Ut&quot;,&quot;code&quot;:&quot;ut sunt eiusmod dolore a&quot;,&quot;in&quot;:&quot;elit sunt dolor&quot;,&quot;context&quot;:{&quot;adipisicing19f&quot;:[&quot;tempor in eiusmod&quot;,&quot;ullamco amet aute ipsum consequat&quot;]}},{&quot;message&quot;:&quot;in officia&quot;,&quot;subCategory&quot;:&quot;exercitation cupidatat amet&quot;,&quot;code&quot;:&quot;dolore magna&quot;,&quot;in&quot;:&quot;n&quot;,&quot;context&quot;:{&quot;esse1&quot;:[&quot;elit s&quot;,&quot;id ex et occaecat&quot;]}}],&quot;links&quot;:{&quot;Lorem11&quot;:&quot;consequat aliquip cillum proident occaecat&quot;},&quot;message&quot;:&quot;ipsum&quot;,&quot;status&quot;:&quot;in Duis qui in&quot;,&quot;subCategory&quot;:{},&quot;id&quot;:&quot;Duis&quot;},{&quot;category&quot;:&quot;eu dolor culpa sunt eiusmod&quot;,&quot;context&quot;:{&quot;culpa56&quot;:[&quot;Duis qui amet anim&quot;,&quot;commodo aliquip ipsum&quot;],&quot;officia4_&quot;:[&quot;exercitation dolor&quot;,&quot;ut Lorem aute sit&quot;]},&quot;errors&quot;:[{&quot;message&quot;:&quot;irure deserunt dolore&quot;,&quot;subCategory&quot;:&quot;aliquip&quot;,&quot;code&quot;:&quot;ut&quot;,&quot;in&quot;:&quot;anim Lorem&quot;,&quot;context&quot;:{&quot;amet_e&quot;:[&quot;nostrud Lorem in&quot;,&quot;voluptate laborum in&quot;],&quot;ut7_c&quot;:[&quot;labore nisi pariatur Lorem&quot;,&quot;aliquip sint&quot;]}},{&quot;message&quot;:&quot;aute culpa eu&quot;,&quot;subCategory&quot;:&quot;ut Ut non est laborum&quot;,&quot;code&quot;:&quot;do tempor velit&quot;,&quot;in&quot;:&quot;sin&quot;,&quot;context&quot;:{&quot;laborum65&quot;:[&quot;laboris&quot;,&quot;nisi&quot;],&quot;officia_55&quot;:[&quot;in&quot;,&quot;dolore in&quot;]}}],&quot;links&quot;:{&quot;consequat_28&quot;:&quot;qui culpa&quot;,&quot;minim6&quot;:&quot;dolor ullamco commodo&quot;,&quot;Lorem_f&quot;:&quot;sint anim sit&quot;},&quot;message&quot;:&quot;quis deserunt nulla dolore eu&quot;,&quot;status&quot;:&quot;eu cillum reprehenderit anim&quot;,&quot;subCategory&quot;:{},&quot;id&quot;:&quot;eiusmod sint esse dolor exercitation&quot;}]}