Go SDK

go get github.com/SendAfrica/GO-SDK

package main
 
import (
    "context"
    "log"
    "os"
 
    sendafrica "github.com/SendAfrica/GO-SDK"
)
 
func main() {
    client := sendafrica.NewClient(os.Getenv("SENDAFRICA_API_KEY"))
 
    result, err := client.SMS.Send(context.Background(), sendafrica.SendSMSRequest{
        To:      "0712345678",
        Message: "Your verification code is 4921.",
    })
    if err != nil { log.Fatal(err) }
 
    log.Printf("sent: %s status=%s credits=%d", result.MessageID, result.Status, result.CreditsUsed)
}

client := sendafrica.NewClient(apiKey,
    sendafrica.WithBaseURL("https://api.sendafrica.online/v1"),
    sendafrica.WithMaxRetries(3),
    sendafrica.WithUserAgent("my-app/1.0"),
    sendafrica.WithWebhookSecret("whsec_..."),
)

result, err := client.SMS.Send(ctx, sendafrica.SendSMSRequest{
    To:      "0712345678",
    Message: "Welcome to SendAfrica!",
    Sender:  "SENDAFRICA", // optional; defaults when omitted
})

result, err := client.SMS.Send(ctx, sendafrica.SendSMSRequest{
    To: "0712345678", Message: "Retry-safe send",
}, sendafrica.RequestOptions{IdempotencyKey: "order-123"})

res, err := client.SMS.SendMany(ctx, sendafrica.SendManyRequest{
    Messages: []sendafrica.SendManyMessage{
        {To: "0712345678", Message: "Hi Ali"},
        {To: "0765432109", Message: "Hi Zainab", IdempotencyKey: "m2"},
    },
    RateLimitPerSec: 10.0, // default 10
})
// res.Results → []SMSResult, res.Failed → []BulkSMSFailedItem{Index,To,Error}

res, err := client.SMS.Bulk(ctx, sendafrica.BulkSMSRequest{
    To:      []string{"0712345678", "0765432109"},
    Message: "Black Friday starts now!",
    Sender:  "SENDAFRICA",
})
// res.Total, res.Sent, res.Failed, res.Results []BulkSMSRecipient{To,Status,MessageID,CreditsUsed,Error}

logs, err := client.SMS.Logs(ctx, sendafrica.MessageLogQuery{
    Page:     1,
    PerPage:  25,
    Status:   "delivered", // pending | sent | delivered | failed
    Search:   "0712345678",
    DateFrom: "2026-09-01T00:00:00Z",
})
// logs.Items []MessageLog, logs.Total/Page/PerPage/TotalPages

info := client.SMS.Analyze("Hello world")
fmt.Println(info.Encoding, info.Parts, info.CreditsRequired)

bal, err := client.Credits.Balance(ctx)
// bal.AccountID, bal.Balance (integer credit count)
 
history, err := client.Credits.History(ctx, sendafrica.PageQuery{Page: 1, PerPage: 25})
// []CreditTransaction{ID,Type,Amount,BalanceAfter,Description,CreatedAt}

rates, err := client.Rates.List(ctx)                       // []CountryRate{Name,ISO2,DialCode,RateTZS}
tz, err := client.Rates.Get(ctx, "TZ")                     // CountryRate for one country by ISO2 or name

reqs, err := client.SenderIDs.Requirements(ctx)           // SenderIDRequirements (eligibility, rules, docs)
usable, err := client.SenderIDs.Usable(ctx, "")            // []UsableSenderID available for sending
list, err := client.SenderIDs.List(ctx)                    // []SenderID registered on the account
 
newID, err := client.SenderIDs.Create(ctx, sendafrica.CreateSenderIDRequest{
    Name:          "MYBRAND",
    Country:       "TZ",
    Purpose:       "Marketing",
    SampleMessage: "Welcome to MYBRAND",
    // Documents: []SenderIDDocumentInput{{RequirementUID, Filename, ContentBase64}},
})
 
one, err := client.SenderIDs.Get(ctx, newID.ID)

rate, err := client.Payments.Rate(ctx)                     // VoucherRate{MinAmountTZS, Tiers}
 
payment, err := client.Payments.Create(ctx, sendafrica.CreateVoucherRequest{
    Amount:   10000,  // TZS — converted to credits server-side
    Provider: "snippe",
    Phone:    "0712345678",
})
// payment.ID, payment.Status, payment.CreditAmount

func webhookHandler(w http.ResponseWriter, r *http.Request) {
    body, _ := io.ReadAll(r.Body)
    signature := r.Header.Get("X-SendAfrica-Signature")
 
    event, err := client.Webhooks.Parse(body, signature, "") // "" uses the client-level secret
    if err != nil {
        http.Error(w, "invalid signature", http.StatusUnauthorized)
        return
    }
    fmt.Println(event.Type, event.MessageID, event.Data)
    w.WriteHeader(http.StatusOK)
}

login, err := client.Login(ctx, "dev@example.com", "s3cret")
authed := sendafrica.NewClient("", sendafrica.WithBearerToken(login.AccessToken))
profile, err := authed.Me(ctx)
 
campaign, err := client.CreateCampaign(ctx, sendafrica.CreateCampaignRequest{
    Name:          "Friday blast",
    Message:       "Weekly offer inside",
    ContactListID: 7,
    ScheduledAt:   time.Now().Add(24 * time.Hour),
})

if err != nil {
    var apiErr *sendafrica.APIError
    if errors.As(err, &apiErr) {
        fmt.Println(apiErr.Code, apiErr.Message, apiErr.RequestID, apiErr.StatusCode)
        switch {
        case apiErr.IsRateLimited():       // 429 / rate_limit_exceeded
        case apiErr.IsInsufficientCredits(): // 402 / insufficient_credits
        case apiErr.IsUnauthorized():      // 401 / invalid_api_key
        }
    }
    if errors.Is(err, sendafrica.ErrInvalidPhone) {
        // local phone validation failed
    }
}