We are writing to inform you that several fields, mutations, queries, and types in our GraphQL API and Zapier integration have been deprecated and will be replaced with their equivalent after May 21, 2023.

GraphQL API

• The argument id has been renamed to projectId in project query.

• The field creationTime has been renamed to createdAt.

• The field posts in Project type has been renamed to publications.

• The field updateTime has been renamed to updatedAt.

• The mutation named createPost has been renamed to createPublication.

• The mutation named deletePost has been renamed to deletePublication.

• The mutation named updatePost has been renamed to updatePublication.

• The query named post has been renamed to publication.

Zapier Integration

• The output field with the key creationTime has been renamed to createdAt.

• The output field with the key updateTime has been renamed to updatedAt.

• The output field with the key publicationTime has been renamed to publishedAt.

Please make sure to update your code or integrations to reflect these changes to avoid any disruptions.

If you have any questions or concerns, don’t hesitate to leave a comment or contact us directly.

Have a great holiday season! 🎄

Today, we're introducing new ways to retrieve and subscribe to publication comments so that you can easily include feedback you receive in your existing workflows or pipelines.

These new features complement the existing notification system, which sends an email to all Noticeable project collaborators who have opted to receive notifications whenever a publication comment is authored by one of your users.

The first addition is a new Zapier trigger that, once configured with a Zap, allows you to subscribe to publication comments and receive instant comment payloads that you can forward, handle, and/or process with any of the 5000+ other Zapier integrations:

The second change is the addition of new queries and fields in our GraphQL API to retrieve publication comments:

• We've added a query to list all comments in a given project:

  publicationComments(projectId: ID!): PublicationCommentConnection

• We've added a query that returns publication comments for a given project and comment identifier:

  publicationComment(projectId: ID!, commentId: ID!): PublicationComment

• The Publication type now includes an optional comments field that can be used to list comments for the publication in question.

Sample queries are available on our playground

https://playground.noticeable.io/?token=YOUR_API_TOKEN

You will also notice that all post-related mutations, queries, and types have been deprecated and renamed to publication. Another announcement about these changes will follow in the next few days, but don't be afraid of deprecations - they will remain for at least 4 months before being removed.

A new option has been added to send a copy of any publication email to you or all project collaborators, in 2 clicks. That’s a great way to check how such emails render in your mailbox before sending them to a wider audience.

You will find the option while editing a publication, in step 3 “Summary”:

Upon clicking on the preview link, a dialog appears to select the recipient and customize the prefix to use for the email subject. You just need to click on “Send” to confirm sending a preview email:

It is already possible to customize SEO tags per Newspage publication. Today, you can do the same thing for your Newspage home page.

You can define a custom title page, description, and canonical URL. To improve the display and usability of your links on social media you can even set a custom Open Graph and Twitter Card title, description, and image.

To access the options, open a project on the Noticeable dashboard, click on “Newspage” in the left navigation and scroll down to the new subgroup entitled “Search Engine Optimization (SEO)”:

We’re proud to announce that you can now configure a custom MAIL FROM domain for emails sent by Noticeable. This helps improve deliverability and trust.

The configuration requires a few steps:

1. Click on “Emails” in the left navigation on the Noticeable dashboard.

2. Open the “Email domains” settings group and click “Add domain”.

3. In the dialog that appears enter your company email domain (e.g. acme.com) and click “Continue”.

4. At this stage, you are asked to add a set of DNS records to your domain’s DNS provider. These records are required to prove that you own the domain. Once done, click “Verify”.

Upon verification, your domain is automatically activated and emails you send now appear as coming from your company domain:

Note that Noticeable follows industry standards and once the configuration is completed, your emails are authenticated, thus passing DMARC and SPF verifications.

• Added options to select whether you want to track links and/or opens (both are enabled by default) for emails sent by Noticeable:

  

• Click counts on CTA buttons embedded in emails sent by Noticeable are now collected appropriately.

• Double opt-int subscriptions is the default. Switching to single-opt for subscriptions now requires to be on the Business plan or above.

• Fixed a bug preventing organizations on the Free, Starter and Growth plan to update some basic widget settings without upgrading to the Business plan.

• Similarly to draft publications, metrics for scheduled publications are no longer collected until the publication time is in the past.

Newspages now include a search field that enables full-text search. You can easily find publications based on your own terms. Search applies to publications’ author name, content, and title.

Note that you can combine search terms with label selection to further filter results.

Besides, all sentences related to the new search feature are fully customizable from the Noticeable dashboard:

1. Select Newspage on the left navigation.

2. Open the Phrases settings group.

3. Click the Search category and apply the changes you need:

   

• Email dispatches now include a detailed summary that shows statistics about emails that have been processed (i.e. hard bounces, soft-bounces, complaints, unsubscribes, etc.):

  

• When a hard-bounce or spam complaint is received, the associated email subscription is automatically cleaned, meaning that non-desired content will no longer be sent to such email addresses on next dispatches.

• The publication scheduling feature is now available starting with the Growth plan.

• The emails preview no longer requires an invitation.

• You can now access the history of all email dispatches and filter them by type.

• When removing the draft status of a publication from the step 3 of the editor (Summary), if the publication date and time is 15 minutes older than the current one, you will then see a dialog asking whether you want to set the publication date and time to now.