feat: add portal and embeddable sessions

Author: Justintime50

CHANGELOG.md

@@ -1,5 +1,11 @@
 # CHANGELOG
 
+## Next Release
+
+- Adds the following functions:
+  - `CustomerPortal.CreateAccountLink`
+  - `Embeddable.CreateSession`
+
 ## v7.3.0 (2025-11-10)
 
 - Adds support for `UspsShipAccount`

EasyPost/Models/API/CustomerPortalAccountLink.cs

@@ -0,0 +1,39 @@
+using EasyPost._base;
+using Newtonsoft.Json;
+
+namespace EasyPost.Models.API
+{
+    /// <summary>
+    ///     Class representing a CustomerPortalAccountLink.
+    /// </summary>
+    public class CustomerPortalAccountLink : EphemeralEasyPostObject
+    {
+        #region JSON Properties
+
+        /// <summary>
+        ///     Always returns "CustomerPortalAccountLink".
+        /// </summary>
+        [JsonProperty("object")]
+        public string? Object { get; set; }
+
+        /// <summary>
+        ///     One-time-use session URL for initiating the Customer Portal.
+        /// </summary>
+        [JsonProperty("link")]
+        public string? Link { get; set; }
+
+        /// <summary>
+        ///     One-time-use session URL for initiating the Customer Portal.
+        /// </summary>
+        [JsonProperty("created_at")]
+        public string? CreatedAt { get; set; }
+
+        /// <summary>
+        ///     ISO 8601 timestamp when the link will expire (5 minutes from creation).
+        /// </summary>
+        [JsonProperty("expires_at")]
+        public string? ExpiresAt { get; set; }
+
+        #endregion
+    }
+}

EasyPost/Models/API/EmbeddablesSession.cs

@@ -0,0 +1,40 @@
+using EasyPost._base;
+using Newtonsoft.Json;
+
+namespace EasyPost.Models.API
+{
+    /// <summary>
+    ///     Class representing an EmbeddablesSession.
+    /// </summary>
+    public class EmbeddablesSession : EphemeralEasyPostObject
+    {
+        #region JSON Properties
+
+        /// <summary>
+        ///     Always returns "EmbeddablesSession".
+        /// </summary>
+        [JsonProperty("object")]
+        public string? Object { get; set; }
+
+        /// <summary>
+        ///     Short-lived, one-time-use token that authorizes an Embeddables Components session.
+        ///     Must be provided to the client-side Embeddables script to initialize the component.
+        /// </summary>
+        [JsonProperty("session_id")]
+        public string? SessionId { get; set; }
+
+        /// <summary>
+        ///     ISO 8601 timestamp indicating when the session was created.
+        /// </summary>
+        [JsonProperty("created_at")]
+        public string? CreatedAt { get; set; }
+
+        /// <summary>
+        ///     ISO 8601 timestamp indicating when the session expires.
+        /// </summary>
+        [JsonProperty("expires_at")]
+        public string? ExpiresAt { get; set; }
+
+        #endregion
+    }
+}

EasyPost/Parameters/CustomerPortal/CreateAccountLink.cs

@@ -0,0 +1,49 @@
+using System.Diagnostics.CodeAnalysis;
+using EasyPost.Models.API;
+using EasyPost.Utilities.Internal.Attributes;
+
+namespace EasyPost.Parameters.Claim
+{
+    /// <summary>
+    ///     <a href="https://docs.easypost.com/docs/customer-portals#creating-a-portal-session">Parameters</a> for <see cref="EasyPost.Services.CustomerPortalService.CreateAccountLink(CreateAccountLink, System.Threading.CancellationToken)"/> API calls.
+    /// </summary>
+    [ExcludeFromCodeCoverage]
+    public class CreateAccountLink : BaseParameters<Models.API.CustomerPortalAccountLink>
+    {
+        #region Request Parameters
+
+        /// <summary>
+        ///     Type of Customer Portal session.
+        /// </summary>
+        [TopLevelRequestParameter(Necessity.Required, "session_type")]
+        public string? SessionType { get; set; }
+
+        /// <summary>
+        ///     The User ID of the sub account for which the portal session is being created.
+        /// </summary>
+        [TopLevelRequestParameter(Necessity.Required, "user_id")]
+        public string? UserId { get; set; }
+
+        /// <summary>
+        ///     The URL to which the sub account will be redirected if the session URL is expired, reused, or otherwise invalid.
+        ///     This should trigger a new session request.
+        /// </summary>
+        [TopLevelRequestParameter(Necessity.Required, "refresh_url")]
+        public string? RefreshUrl { get; set; }
+
+        /// <summary>
+        ///     The URL to which the sub account will be redirected after exiting the Customer Portal session.
+        ///     This does not confirm completion of the flow; webhook or API polling is recommended for confirmation.
+        /// </summary>
+        [TopLevelRequestParameter(Necessity.Required, "return_url")]
+        public string? ReturnUrl { get; set; }
+
+        /// <summary>
+        ///     Used to configure the Customer Portal session.
+        /// </summary>
+        [TopLevelRequestParameter(Necessity.Optional, "metadata")]
+        public Dictionary<string, object>? Metadata { get; set; }
+
+        #endregion
+    }
+}

EasyPost/Parameters/Embeddable/CreateSession.cs

@@ -0,0 +1 @@
+// TODO

EasyPost/Services/CustomerPortalService.cs

@@ -0,0 +1,39 @@
+using System.Threading;
+using System.Threading.Tasks;
+using EasyPost._base;
+using EasyPost.Exceptions.General;
+using EasyPost.Http;
+using EasyPost.Models.API;
+using EasyPost.Utilities.Internal.Attributes;
+
+namespace EasyPost.Services
+{
+    /// <summary>
+    ///     Class representing a set of CustomerPortal-related functionality.
+    /// </summary>
+    // ReSharper disable once ClassNeverInstantiated.Global
+    public class CustomerPortalService : EasyPostService
+    {
+        /// <summary>
+        ///     Initializes a new instance of the <see cref="CustomerPortalService" /> class.
+        /// </summary>
+        /// <param name="client">The <see cref="EasyPostClient"/> to tie to this service and use for API calls.</param>
+        internal CustomerPortalService(EasyPostClient client)
+            : base(client)
+        {
+        }
+
+        #region CRUD Operations
+
+        /// <summary>
+        ///     Create a Portal Session.
+        /// </summary>
+        /// <param name="parameters">Data to use to create the Portal Session.</param>
+        /// <param name="cancellationToken"><see cref="CancellationToken"/> to use for the HTTP request.</param>
+        /// <returns>A <see cref="CustomerPortalAccountLink"/> object.</returns>
+        [CrudOperations.Create]
+        public async Task<CustomerPortalAccountLink> CreateAccountLink(Parameters.CustomerPortal.CreateAccountLink parameters, CancellationToken cancellationToken = default) => await RequestAsync<CustomerPortalAccountLink>(Method.Post, "customer_portal/account_link", cancellationToken, parameters.ToDictionary());
+
+        #endregion
+    }
+}

EasyPost/Services/EmbeddableService.cs

@@ -0,0 +1 @@
+// TODO