• Issue #1516: Instagram Basic Display API Client removed (Breaking change)
• Issue #1517: old versions from Version enum removed (Breaking change)
• Issue #1512: license info changed to 2025
• minor refactorings

• Issue #1523: quote and repost id added to TdMedia

• Issue #1519: version added to enum
• Issue #1520: legacy_instagram_media_id added to IgMedia
• Issue #1522: legacy_instagram_comment_id added to IgComment

• Issue #1518: assertj-core updated
• Issue #1514: mockito-junit updated

• Issue #1398: new Threads permissions added
• Issue #1399: profile type added
• Issue #1400: media type added
• Issue #1401: rate limit type added
• Issue #1402: reply type added
• Issue #1403: insights checked

• Issue #1385: bump version.junit from 5.10.1 to 5.10.2
• Issue #1386: bump org.assertj:assertj-core from 3.25.2 to 3.25.3
• Issue #1387: bump org.mockito:mockito-junit-jupiter from 5.10.0 to 5.11.0
• Issue #1391: bump org.apache.maven.plugins:maven-compiler-plugin from 3.12.1 to 3.13.0
• Issue #1392: bump org.apache.maven.plugins:maven-gpg-plugin from 3.1.0 to 3.2.2
• Issue #1394: bump org.apache.maven.plugins:maven-source-plugin from 3.3.0 to 3.3.1
• Issue #1395: bump org.projectlombok:lombok from 1.18.30 to 1.18.32
• Issue #1396: bump org.jacoco:jacoco-maven-plugin from 0.8.11 to 0.8.12

• Issue #1244: Send Message object added
• Issue #1247: Text message added
• Issue #1249: Message reaction added
• Issue #1251: Result object for sending message added
• Issue #1248: Media message added
• Issue #1254: Location message added
• Issue #1250: Interactive message added

• Issue #1240: incoming webhook status
• Issue #1232: incoming identity message
• Issue #1239: incoming webhook message with type unknown incl. some errors
• Issue #1234: incoming interactive message
• Issue #1238: incoming document message
• Issue #1237: incoming system message
• Issue #1236: incoming ads message
• Issue #1235: incoming audio message
• Issue #1230: incoming sticker message
• Issue #1231: incoming location message
• Issue #1233: incoming button message
• Issue #1216: incoming image message
• Issue #1215: incoming text message

• Issue #1170: basic support in enum
• Issue #1171: Instagram type changes
• Issue #1172: deprecated fields in page object
• Issue #1173: deprecated fields in User type
• Issue #1174: New User Profile Fields in Instagram Messaging API
• Issue #1175: new fields in Video object

• Issue #1071: version added to Version enum
• Issue #1072: new permissions added, old ones marked as deprecated

• Issue #1033: Version enum added
• Issue #1036: IceBreaker object added
• Issue #1034: Reply and Reaction support added to messenger webhook
• Issue #1038: Ads - user_tasks instead of user_role

• Issue #1013: basic support
• Issue #1015: Messenger templates marked as deprecated
• Issue #1014: Location quick reply is deprecated

• Issue #989: Version enum changed
• Issue #990: deprecated fields in Post type
• Issue #991: conversation webhook is deprecated now

• Issue #936 - Improve "Setting persistent menu" section
  Thanks to @eximius313 for the hints
• Issue #935 - Improve "Setting a Welcome Message" section
  Thanks to @eximius313 for the hints

• Issue #938 - extract short circuit methods
• Issue #939 - remove the JsonMappingErrorHandler

• Issue #899: basic support
• Issue #900: LiveVideo replace type with source field

• Issue #885: Basic support
• Issue #886: Permissions added and cleanup

• Issue #881: picture conversion helper added
• Issue #880: Date mapping added
• Issue #877: old readonly API removed

Instagram support

• Issue #854: add instagram_business_account to Page type
• Issue #855: create IgUser type
• Issue #856: IgMedia type
• Issue #859: webhook objects
• Issue #857: IgComment type
• Issue #858: missing connections added
• Issue #851: Request for support of Facebook Instagram API
  Thanks to @martinmalek for the hint

Messenger Platform 2.3 changes

• Issue #861: Phone and email quick replies
• Issue #862: Request thread control for the Handover Protocol

• Issue #321: Replace "Json.org" parser with "minimal-json" parser
• Issue #519: unicode (emoji) fix added to minimal-json (port of #501)
• Issue #585: improve the JsonAssert util

• Issue #31: support user-definable logging via slf4j
  Great idea @revetkn
• Issue #635: rename logger categories

• Issue #339: Code quality fix - Collection.isEmpty should be used
  Thanks to @faisal-hameed for this PR
• Issue #345: Code quality fix - @Override annotation should be used
  Thanks to @faisal-hameed for this PR
• Issue #344: Code quality fix - Redundant field intializers
  Thanks to @faisal-hameed for this PR
• Issue #189 and #190: create collections with needed size
  Thanks to @profes for the report and PR

• Issue #299: StoryAttachment changed
• Issue #257: Post and Comment use same Attachment type
• Issue #302: Graph API 1.0 support removed
• Issue #314: Event#getPicture returns Picture instead of String
• Issue #311: Remove Attribution field from Post type
• Issue #310: Event venue field has wrong type
• Issue #323: Remove deprecated classes from Post type
• Issue #337: Photo#getComments() returns List of comments instead of Comments object
  Thanks to @vido88 for this report
• Issue #364: Remove inner class MessageTag from Post
• Issue #80: Exception Generator added
  Thanks to @slumx for the report
• Issue #195: Likes type improved
• Issue #113: Event can contain multiple venues
  Thanks to @guychauliac for the PR
• Issue #367: old inner class comments removed from comment type
• Issue #402: Page field location should be of type Location
• Issue #301: deprecated FQL methods removed
• Issue #609: Remove experimental classes
• Issue #467: Use Comments and Likes in Photo type
• Issue #452: fix bug from #448

• Issue #816: 2.11 Version added
• Issue #817: Webhook sender_name and sender_id is from now

• Issue #819: messaging_type enum added
• Issue #820: Broadcast API
• Issue #818: Add media template

• Issue #760 and #773: basic support added
  Thanks to @jcdavidconde for the hint
• Issue #763: Webhook updates for event added to factory

• Issue #757: shareable option is missing in Send API
• Issue #766 : Policy Enforcement Callback

• Issue #713: basic Graph API 2.9 support
• Issue #714: short_name added to User type
• Issue #716: engagement added to URL type
• Issue #715: fields in subscriptions object changed
  This is a breaking change! Check the javadoc

• Issue #717: ID matching types added

• Issue #680: PersistentMenu added
• Issue #683: quick replies limit increased to 11
• Issue #682: locale added to Greeting
• Issue #681: optional name field added to phone recipient
• Issue #676: image_aspect_ratio added to GenericTemplatePayload

• Issue #619: Passing parameters via M.me links
• Issue #620: List Template
• Issue #621: seq id is deprecated
• Issue #622: Checkbox plugin support
  Thanks to @marceloverdijk for the hint
• Issue #623: messaging_referral event
  Thanks to @marceloverdijk for the hint

• Issue #602: Readme changed to describe only basic usage
• Issue #604: Experimental package marked as deprecated
• Issue #608: unused imports removed

• Issue #589: Feed Targeting
• Issue #590: User Bios
• Issue #588: Basic support

• Issue #517: Add missing field to VideoCopyright

• Issue #594: add sticker_id to MessageItem class and MessagingAttachment class
  Thanks to @Abdelrahman-Hasan for the hint
• Issue #596: Improve the SendResponse
  Thanks to @marceloverdijk for the hint
• Issue #584: add attachment_id and is_reusable to MediaAttachment class
  Thanks to @Abdelrahman-Hasan for the hint
• Issue #581: Please add a Message#addQuickReplies (multiple)
  Thanks to @marceloverdijk for the hint
• Issue #582: Throw exception on adding too many QuickReplies
• Issue #580: Wrong Date in FlightSchedule leads to error code when sending
• Issue #592: Messenger documentation bug
  Thanks to @vraffy for the hint

• Issue #566: new QuickReply types added
  Thanks to @marceloverdijk for the hint
• Issue #567: CallButton added
• Issue #568: ShareButton added
• Issue #571: Field webview_height_ratio added to WebButton
• Issue #569: BuyButton added, Payment webhook type added
• Issue #570: Webview and Extension fields added

• Issue #556: log exceptions that can be ignored
• Issue #559: log more exceptions and use lastIndexOf with Char
• Issue #557: use isEmpty() instead of size() where possible
• Issue #561: catch Exception instead of Throwable
• Issue #564: types should extend AbstractFacebookType

• Issue #435: missing field content_tags in Video type
• Issue #438: missing PageLabel type
• Issue #441: Messaging webhook types (Messenger Platform)
• Issue #443: Send Api types (Messenger Platform)
• Issue #445: Device Login URL changed
  Thanks to DigitalXXL

• Issue #433: PageAdminNote type is missing
• Issue #431: Pages type likes renamed to fan_count
• Issue #430: Post reactions
• Issue #428: Video type has field live_audience_count
• Issue #427: Video type new field live_status type
• Issue #426: new permission pages_messaging_phone_number
• Issue #425: new permission pages_messaging
• Issue #437: reactions added to Video and Photo type
• Issue #424: Version enum

• Issue #200: Graph API 2.3 hint
  Thanks to Aurelie Vache
• Issue #201: add new API Version to enum
• Issue #202: add user_posts permission
• Issue #203: Graph API debug mode
• Issue #204: add field admin_creator to Post-type (Page Post only)
• Issue #205: new page fields
• Issue #206: new page settings
• Issue #208: Page featured videos collection
• Issue #209: published field added to Video-type
• Issue #210: Video custom thumbnail
• Issue #211: Video new fields
• Issue #212: read_friendlists permission is read_custom_friendlists
• Issue #213: publish_pages permission

Support for appsecret_proof functionality.
Thanks to Daniel Piet and Mike Champion.

Now support signed request parsing with new FacebookClient.parseSignedRequest().
Thanks to Josef Gierbl for the patch.

Support for specifying content type for binary attachments.
Thanks to UglyTroLL.

Added can_comment and parent fields to Comment-type.
BREAKING CHANGE:

Post.getCount() is now Post.getTotalCount() per July FB API changes.
Please request '{id}/comments?summary=true' explicitly if you would like the summary field which contains the total_count
Thanks to Jens Peters for the patch.

FacebookGraphException now has getErrorCode() and getErrorSubcode() in the event that FB returns these. Previously this was only available for FacebookOAuthException.
Thanks to Peter Vahlstrup.

Fix for Venue-type (added new id field)
Thanks to sbisht and neXus1987

Added missing fields to Message type.
Thanks to Felipe Kurkowski.

Added missing fields to Comment type.
Thanks to Jan Schweizer.

Added integer (0, 1) -> boolean JSON serialization.
Thanks to Tom Zellman.

Convenience override of FacebookClient.executeBatch()
Thanks to loicAG.

Added missing fields to Event-type

BREAKING CHANGE:

We are no longer passing around InputStream objects to represent binary files when publishing - they have been replaced by instances of the new com.restfb.BinaryAttachment type. So this method:

<T> T FacebookClient.publish(String connection, Class<T> objectType, InputStream inputStream, Parameter... parameters)

is now:

<T> T FacebookClient.publish(String connection, Class<T> objectType, BinaryAttachment binaryAttachment, Parameter... parameters)

This change was necessary to support correct video uploads (FB now requires a filename with a video extension, e.g. .mov) and the new Batch API. Documentation and usage examples for com.restfb.BinaryAttachment are available on http://restfb.com.

Added support for the new Batch API. The two new methods are:

List<BatchResponse> FacebookClient.executeBatch(BatchRequest... batchRequests)
List<BatchResponse> FacebookClient.executeBatch(List<BatchRequest> batchRequests, List<BinaryAttachment> binaryAttachments)

Thanks to everyone who asked for this!

Added support for the new video upload API endpoint via https://graph-video.facebook.com and fixed a multipart filename bug that broke video uploads.
Thanks to yylaob@gmail.com for the filename bugfix and saylxxx@gmail.com and everyone else who asked for this!

All types under com.restfb.types now implement Serializable.
Thanks to everyone who asked for this!

Fixed a numeric precision bug in JsonObject.getLong() which caused large numbers to be rounded incorrectly.
Thanks very much to ps@king.com for finding this and providing a patch.

`DefaultJsonMapper`` can now instantiate types with no-argument constructors that are private, protected, or package-private - you no longer have to expose your constructors if you don't want to.

JsonMapper.toJson(Object object, boolean ignoreNullValuedProperties) was added, which enables you to turn a Java object into JSON without including any properties with null values.

Added comments, likes, position, and images fields to Photo type.
Thanks to Andre Oosthuizen and Grace Win.

Added name, tags, and source fields to Video and marked message as deprecated.
Thanks to Andre Oosthuizen and Marcel Stoer.

Added likes and access_token fields to Page and deprecated fan_count.
Thanks to Shashank Agarwal and jspyeatt.

Added object_id field to Post.
Thanks to Grace Win.

Added username field to User.
Thanks to Iwan Gulenko.

Added city, state, and country fields to Checkin.Place.Location.
Thanks to Thom Nichols.

Removed messages and likes fields from StatusMessage because they're now connections. Added the type field to StatusMessage.
Thanks to volkenborn@yahoo.com.

You can now instruct DefaultJsonMapper how to handle mapping exceptions, e.g. ignoring them and mapping as null instead of throwing an exception.

FacebookClient facebookClient = new DefaultFacebookClient("MY_ACCESS_TOKEN",
  new DefaultWebRequestor(), new DefaultJsonMapper(new JsonMappingErrorHandler() {
    public boolean handleMappingError(String unmappableJson, Class<?> targetType, Exception e) {
      // Here you might log the fact that JSON mapping failed.
      err.println(format("Uh oh, mapping %s to %s failed...", unmappableJson, targetType));

      // Returning true tells the mapper to map this JSON as null and keep going.
      // Returning false tells the mapper to throw an exception.
      return true;
    }
  }
));

The default behavior is still to throw an exception immediately on mapping errors, this callback interface is your way of saying "I know what I'm doing and want to handle errors myself". Very useful for keeping your app running in production when Facebook changes the API unexpectedly.
Thanks to Igor Kabiljo for the suggestion.

Added new quotes and address and mobile_phone fields to the User type.
Thanks to ne52 for the heads-up about the addition of the quotes field.

DateUtils.toDateFromMonthYearFormat now returns null for 0000-00 instead of 0 AD. Not sure why FB gives us 0000-00 instead of null in some situations, e.g. work start date.

POTENTIALLY BREAKING CHANGE: User.getPicture() has been removed. To get the user's picture, simply construct a URL by hand, e.g. http://graph.facebook.com/USER_ID/picture

Now use java.util.logging instead of Log4j - RestFB now has 0 dependencies.

FacebookException now extends RuntimeException - you no longer have to catch it if you don't want to.
Thanks to Jeff Schnitzer.

Removed contains attribute on @Facebook annotation since it is no longer necessary.
Thanks to Igor Kabiljo for the initial patch.

Exposed and cleaned up previously-internal RestFB's repackaged JSON.org code in the new com.restfb.json package.

You may now tell JsonMapper to map to JsonObject, which permits you to have total control over result mapping at run time (as opposed to the compile-time-only @Facebook annotation).

JsonMapper now supports having a Facebook JSON field mapped to multiple @Facebook-annotated Java fields. This addresses the issue of Facebook returning the same field name but differently-structured data in certain situations. See issues 56 and 90 for details.
Thanks to Daniel Winterstein, Igor Kabiljo, Marcel Stoer, Pramod Biligiri, and Tom Schindl for their input.

Exposed and cleaned up previously-internal RestFB utilities in the new com.restfb.util package.

Added new exception package com.restfb.exception and exception types (FacebookOAuthException, FacebookQueryParseException) for simple handling of common Graph API exception types.
Thanks to Jeff Schnitzer.

Added formal support for Connection paging by URL via FacebookClient.fetchConnectionPage() and the new Connection.getPreviousPageUrl()/getNextPageUrl(). No more manual offset calculation required.

Example:

 Connection<Post> myFeed = facebookClient.fetchConnection("me/feed", Post.class);

 if(myFeed.hasNext()) {
   Connection<Post> myFeedPage2 = facebookClient.fetchConnectionPage(myFeed.getNextPageUrl(), Post.class);
   // ...
 }

Thanks to Jakub Danilewicz.

Added FacebookClient.convertSessionKeysToAccessTokens() method.
Thanks to Scott Hernandez and Mattia Tommasone.

Fixed issue where User.birthday causes mapping to fail if "show only month & date" is set on FB.
Thanks to Kalle Korhonen.

Old REST API now always uses the HTTPS endpoint.
Thanks to Christopher Oestlund.

Added embed_html, picture, icon, comments to Video type.
Thanks to Fahd Akbar and Chris Pruett.

Added Account type to support impersonation feature.
Thanks to jovanovich.

Fixed error-handling issues: 1) where HTTP 400 error code would throw an incorrect exception and 2) where error response JSON would not get correctly read in this and other error situations.
Thanks to Igor Kabiljo, ovonick, and everyone else who reported this.

Performance enhancement: ReflectionUtils now caches @Facebook field information so we never have to reflect more than once.
Thanks to Igor Kabiljo for the patch.

Added Checkin type.
Thanks to everyone else who requested this and Colin Britton for the checkin code snippet.

Added StatusMessage type.

Added middle_name field to User type.
Thanks to Fehmican Saglam.