Avtrz
BlogGuides
Guides4 min read

Real photos in your HubSpot contacts in 4 minutes

A click-by-click walkthrough: no SDK, no Zapier flows, no IT ticket. Just a property and an image URL.

Morgan Chen··4 min read
4 min
guide · no-code
guide · no-code

This is a guide, so it is short. By the end your HubSpot contacts will show real business profile photos instead of grey initials. No SDK, no Zapier flow, no IT ticket. You need a HubSpot account you can administer and four minutes.

Step one: create an API key

In the Avtrz console, open API keys and create a key. Add your HubSpot portal domain to the key’s allow-list so the key only works where you expect it to. Copy the key somewhere safe; you will paste it once.

Step two: add a contact property

In HubSpot, go to Settings → Properties and create a new contact property. Give it the name Profile photo and the field type Single-line text. This property will hold one image URL per contact.

Step three: fill it with an Avtrz URL

Avtrz builds an image URL from something you already have on the contact, usually their work email or a handle. The pattern is the same for every contact:

URLcopy / paste
https://avtrz.dev/v1/avatar?email={{contact.email}}&size=96&key=YOUR_KEY
One pattern, one property. HubSpot stores the URL; Avtrz resolves the photo.

If you are importing contacts from a spreadsheet, add a column that writes this URL for each row and map it to the Profile photo property on import. For contacts already in HubSpot, a single bulk edit fills the property in one pass.

Step four: show it

Add the Profile photo property to your contact views and to any card or record sidebar where a face helps. HubSpot renders the URL as an image. Avtrz returns a 404 when no public photo exists, so keep HubSpot’s default initials as the fallback; it already handles the empty case for you.

That is the whole guide. One property, one URL pattern, and a contact list that looks like it is about people. If you later want this in your own product instead of inside HubSpot, the same URL works anywhere an <img> tag does.

Written by
Morgan Chen
Product at Avtrz. Writes the guides, so they stay short.
More posts
Twice a month, max

Get the next customer story in your inbox.

Engineering posts, customer stories, and the occasional changelog. Unsubscribe in one click.

Real photos in your HubSpot contacts in 4 minutes · Avtrz Blog