FoPost.Sdk 0.1.0

FoPost.Sdk

Official .NET SDK for the FoPost API. Schedule and publish to +30 social platforms from your code.

dotnet add package FoPost.Sdk

Requires .NET 8 or newer. No third-party dependencies.

0.x release. The public API is still settling and minor versions may contain breaking changes. Pin an exact version if that matters to you.

Quick start

using FoPost;

using var client = new FoPostClient(Environment.GetEnvironmentVariable("FOPOST_API_KEY")!);

// List your accounts
var accounts = await client.Accounts.ListAsync("9b2f6c1e-…");

// Create a post, then publish it immediately
var post = await client.Posts.CreateAsync(
    workspaceId: "9b2f6c1e-…",
    text: "Hello from the SDK",
    accounts: accounts.Select(account => account.Id));

await client.Posts.PublishAsync(post.Id);

// Schedule for later
await client.Posts.CreateAsync(new CreatePostOptions
{
    WorkspaceId = "9b2f6c1e-…",
    Status = PostStatuses.Scheduled,
    ScheduleAt = new DateTimeOffset(2026, 6, 1, 10, 0, 0, TimeSpan.Zero),
    Content = new List<PostContent> { new("Scheduled with the SDK") },
    Accounts = new List<string> { accounts[0].Id },
});

Create an API key in the dashboard under Settings → API Keys. A key is limited to the scopes granted at creation — the calls above need posts and accounts.

Configuration

using var client = new FoPostClient(new FoPostClientOptions
{
    ApiKey = "fp_…",                        // defaults to $FOPOST_API_KEY
    BaseUrl = "https://api.fopost.com",     // override for staging or self-hosted
    Timeout = TimeSpan.FromSeconds(30),
    MaxRetries = 3,                         // total attempts on a 429, including the first
    HttpClient = httpClientFromFactory,     // optional; the SDK will not dispose it
});

FoPostClient is thread-safe and meant to be long-lived — register it as a singleton rather than constructing one per request. With IHttpClientFactory:

services.AddHttpClient("fopost");
services.AddSingleton(provider => new FoPostClient(new FoPostClientOptions
{
    HttpClient = provider.GetRequiredService<IHttpClientFactory>().CreateClient("fopost"),
}));

Paging

ListAsync returns one page plus its Meta. ListAllAsync walks every page for you:

await foreach (var post in client.Posts.ListAllAsync(new ListPostsOptions
{
    WorkspaceId = "9b2f6c1e-…",
    Status = PostStatuses.Scheduled,
}))
{
    Console.WriteLine($"{post.ScheduleAt:u}  {post.Content.FirstOrDefault()?.Text}");
}

Partial updates

Every field on UpdatePostOptions is an Optional<T>, so "leave this alone" and "clear this" stay different things:

await client.Posts.UpdateAsync(post.Id, new UpdatePostOptions
{
    Title = "New title",                    // sent
    Summary = Optional<string?>.Of(null),   // sent as null, clearing it
    // ScheduleAt is untouched — not sent at all
});

AI features

// Caption assist — accepts an API key carrying the `ai` scope
var caption = await client.Ai.GenerateCaptionAsync(new GenerateCaptionOptions
{
    CurrentCaption = "shipping a new feature",
    Platforms = new List<string> { Platforms.Twitter, Platforms.LinkedIn },
});

// Check your balance
var balance = await client.Ai.CreditsAsync();
Console.WriteLine($"{balance.CreditsRemaining} of {balance.CreditsTotal} credits left");

RewriteAsync and RepurposeUrlAsync are dashboard-session endpoints: they need a BearerToken rather than an API key, and answer 401 to a key.

Error handling

Every non-2xx response raises a FoPostException carrying the API's status, error code, and body.

try
{
    await client.Posts.PublishAsync(post.Id);
}
catch (FoPostRateLimitException error)
{
    Console.WriteLine($"Slow down for {error.RetryAfter}");
}
catch (FoPostPaymentRequiredException error)
{
    Console.WriteLine($"Upgrade at {error.UpgradeUrl}");
}
catch (FoPostException error)
{
    Console.WriteLine($"API {error.Status} ({error.Code}): {error.Message}");
}

A 429 is retried automatically, up to MaxRetries attempts, waiting for the interval the API asks for in Retry-After. The exception is raised only once the retries are spent.

Resources

The API has more endpoints than the SDK wraps — analytics, webhooks, automations, media, and communities among them. RequestAsync reaches any of them with the same auth, retries, and error handling:

var overview = await client.RequestAsync(
    HttpMethod.Get,
    "/v1/analytics/overview",
    query: new Dictionary<string, object?> { ["workspace_id"] = "9b2f6c1e-…" });

The full surface is documented in the API collection.

Contributing

Issues and pull requests are welcome at fopost/fopost-dotnet.

dotnet build
dotnet test
dotnet pack src/FoPost/FoPost.csproj -c Release

License

MIT