Bug: Bulk API for Contacts not setting Lifecycle Stage




When using the the contact API, HubSpot always sets the lifecycle stage for new contacts as "subscriber".
But, using the bulk API, this lifecycle stage is null so there seems to be a bug.
Could you correct this to get a similar behavior than with single contacts?

Thank you,



Hi @kimnguyen,

Can you give me an example contact that was created via the bulk API and is showing a Lifecycle Stage of null? And if possible, the raw body of the request that created the example contact?


Hi @Derek_Gervais,

Thanks for your quick reaction.
Example contact is here:

And here's the request:

[{"email":"xx@x.com", "properties": [
"property": "firstname",
"value": "Codey"
}]},{"email":"xx@xx.net","properties": [
"property": "firstname",
"value": "Cody"

Kind Regards,


Hi @kimnguyen,

This does seem like it might be on our end. I'll touch base with the team and see what might be going on. I'll reach back out on this topic when I have some more information.


Hi @Derek_Gervais, any information you could share at this point?
This bug has caused problems to an integration we have built for a customer, so we would appreciate some updates.
Thank you in advance!

Kind Regards,


Hi @Derek_Gervais, sorry to bump again this post.
Any updates?




Hi @kimnguyen,

No problem at all, apologies for letting this slip through the cracks. Things have been quite busy lately! This is actually a strange scenario; this endpoint's behavior is inconsistent with the tool, but the behavior (i.e. default Lifecycle Stage) is actually something that the team is reevaluating for the whole product. Therefore, this isn't something that the team is going to fix right now, since it's possible it might be part of a bigger change in the near future.

That said, I can understand how this is causing problems for you. I would strongly recommend setting the Lifecycle Stage property explicitly when creating contacts from here on out. If you wanted 'Subscriber' to remain the 'default' for contacts created via the bulk contacts API, you can simply include the Lifecycle Stage property for every contact you create.

Apologies for the delay here, let me know if you have any other questions!


Hi Derek,
Thanks for your detailed and honest answer.We will check with our customer for the right approach :slight_smile:
Kind Regards,