Explore Plans
Back
Substack

New post by user

This trigger fires when a Substack user you follow publishes a new post across any of their publications.

Developer info

API endpoint slug
substack.new_post_by_user

Trigger fields

Username Text input

Label
Substack username
Helper text
The Substack handle of the author (e.g. taylorlorenz, not the full URL)
Slug
username
Required
true
Can have default value
true

Ingredients

Post title The title of the post.

Slug
post_title
Filter
Substack.newPostByUser.PostTitle
Type
String
Example
February 11, 2026

Post url The direct URL to the post.

Slug
post_url
Filter
Substack.newPostByUser.PostUrl
Type
Web URL
Example
https://heathercoxrichardson.substack.com/p/february-11-2026

Post description The subtitle or one-line description of the post. May be empty if the author did not provide one.

Slug
post_description
Filter
Substack.newPostByUser.PostDescription
Type
String
Example
+ Beast Banking, Clav's mogshot, a brainrot Reels slam poet...

Post excerpt A truncated preview of the post body, approximately 100 words. May be empty for some post types.

Slug
post_excerpt
Filter
Substack.newPostByUser.PostExcerpt
Type
String
Example
Every single time you leave a comment, post a review...

Cover image url The URL of the post's cover image. Empty if no cover image was set.

Slug
cover_image_url
Filter
Substack.newPostByUser.CoverImageUrl
Type
Image URL
Example
https://substack-post-media.s3.amazonaws.com/public/images/example.png

Author name The display name of the post's primary author.

Slug
author_name
Filter
Substack.newPostByUser.AuthorName
Type
String
Example
Heather Cox Richardson

Author photo url The URL of the author's profile photo. May be empty.

Slug
author_photo_url
Filter
Substack.newPostByUser.AuthorPhotoUrl
Type
Image URL
Example
https://substackcdn.com/image/fetch/f_auto,q_auto/example.jpeg

Publication name The name of the Substack publication this post was published in.

Slug
publication_name
Filter
Substack.newPostByUser.PublicationName
Type
String
Example
Letters from an American

Published date The date and time the post was published, in UTC.

Slug
published_date
Filter
Substack.newPostByUser.PublishedDate
Type
Date with time (ISO8601)
Example
2020-07-08T04:17:06+05:00

Word count The number of words in the post, as a string. May be empty for podcast or video posts.

Slug
word_count
Filter
Substack.newPostByUser.WordCount
Type
String
Example
1011

Post type The type of the post. One of: newsletter, podcast, thread, video.

Slug
post_type
Filter
Substack.newPostByUser.PostType
Type
String
Example
newsletter

Is paywalled Whether the post requires a paid subscription to read. Returns 'true' or 'false'. Derived from the post's audience field.

Slug
is_paywalled
Filter
Substack.newPostByUser.IsPaywalled
Type
String
Example
false

Podcast url The direct URL to the podcast audio file. Empty unless PostType is 'podcast'.

Slug
podcast_url
Filter
Substack.newPostByUser.PodcastUrl
Type
File URL
Example
https://api.substack.com/api/v1/audio/upload/example/src

Video url The direct URL to the video file. Empty unless the post contains a video upload.

Slug
video_url
Filter
Substack.newPostByUser.VideoUrl
Type
File URL
Example
https://substack-video.s3.amazonaws.com/video_upload/post/example.mp4

Applets using this Trigger