> ## Documentation Index
> Fetch the complete documentation index at: https://docs.handauncle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Social Media URLs

> Returns social media URLs for Facebook, Instagram, LinkedIn, and Twitter.

Retrieve social media profile URLs for Facebook, Instagram, LinkedIn, and Twitter.

This endpoint provides all social media links that should be displayed in the mobile app,
allowing users to connect with Handa Uncle on various social platforms.

## Use Cases

* Display social media icons in the app
* Share buttons linking to social profiles
* About/Connect screens
* Footer social links

## Response

Returns a `socialMediaUrls` object containing:

* `facebook`: Facebook page URL
* `instagram`: Instagram profile URL
* `linkedin`: LinkedIn company page URL
* `twitter`: Twitter/X profile URL

## Example

### Request

```bash cURL theme={null}
curl -X GET 'https://api.handauncle.com/app/config/social-media-urls' \
  -H 'Accept: application/json'
```

```javascript JavaScript theme={null}
const response = await fetch('https://api.handauncle.com/app/config/social-media-urls');
const { data } = await response.json();

// Render social media buttons
const socialLinks = data.socialMediaUrls;
console.log('Facebook:', socialLinks.facebook);
console.log('Instagram:', socialLinks.instagram);
console.log('LinkedIn:', socialLinks.linkedin);
console.log('Twitter:', socialLinks.twitter);
```

```kotlin Kotlin/Android theme={null}
val client = OkHttpClient()
val request = Request.Builder()
    .url("https://api.handauncle.com/app/config/social-media-urls")
    .get()
    .build()

val response = client.newCall(request).execute()
val json = JSONObject(response.body?.string())
val socialUrls = json.getJSONObject("data").getJSONObject("socialMediaUrls")

val facebookUrl = socialUrls.getString("facebook")
val instagramUrl = socialUrls.getString("instagram")
```

### Response

```json theme={null}
{
  "success": true,
  "data": {
    "socialMediaUrls": {
      "facebook": "https://facebook.com/handauncle",
      "instagram": "https://instagram.com/handauncle",
      "linkedin": "https://www.linkedin.com/company/handauncle",
      "twitter": "https://twitter.com/handauncle"
    }
  },
  "meta": {
    "timestamp": "2025-12-10T14:32:18.445Z",
    "request_id": "req_674e2f4a8c1b3d5e7f9a2b4c"
  }
}
```

## See Also

* [Update Social Media URLs](/api-reference/endpoint/app-config-update-social-urls) - Admin endpoint to modify these URLs
* [Get All Configuration](/api-reference/endpoint/app-config) - Get both system and social media URLs


## OpenAPI

````yaml GET /app/config/social-media-urls
openapi: 3.1.0
info:
  title: Handa Uncle API
  version: 1.0.0
  description: Public specification for the Handa Uncle web and mobile APIs.
  contact:
    name: Handa Uncle Engineering
    email: hello@handauncle.com
servers:
  - url: https://handauncle-backend-prod-205012263523.asia-south1.run.app
    description: Prod API base (Cloud Run)
  - url: https://api.handauncle.com
    description: Production
  - url: https://staging-api.handauncle.com
    description: Staging
  - url: http://localhost:8080
    description: Local development
security: []
tags:
  - name: Mobile App
    description: Endpoints used by the native Handa Uncle app.
  - name: Platform
    description: Cross-service operational endpoints.
  - name: Auth
    description: Authentication endpoints handled by the backend adapter.
  - name: AI
    description: LLM chat endpoints supporting streaming and device-auth guests.
  - name: OTP
    description: Phone OTP lifecycle powered by Exotel.
  - name: Webhooks
    description: Server-to-server hooks invoked by Auth0.
  - name: Conversations
    description: Authenticated user conversation management.
  - name: Chat Share
    description: Create, manage, and consume shared conversations.
  - name: Files
    description: Upload, list, and delete user files.
  - name: Prompt management
    description: Admin and public APIs for managing masked pre-prompts.
  - name: User Profile
    description: Profile card collection and user data for personalized AI responses.
  - name: Visual Embeds
    description: Manage visual embed images that attach to AI chat responses.
  - name: Second Opinion
    description: Admin and public APIs for Second Opinion suggestion cards.
  - name: Profile Cards
    description: >-
      APIs for managing profile card questions used in onboarding and
      personalization.
paths:
  /app/config/social-media-urls:
    get:
      tags:
        - Mobile App
      summary: Get social media URLs configuration
      description: >-
        Returns social media URLs for Facebook, Instagram, LinkedIn, and
        Twitter.
      operationId: getSocialMediaUrls
      responses:
        '200':
          description: Social media URLs returned successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SocialMediaUrlsResponseEnvelope'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  schemas:
    SocialMediaUrlsResponseEnvelope:
      type: object
      properties:
        success:
          type: boolean
          enum:
            - true
        data:
          $ref: '#/components/schemas/SocialMediaUrlsData'
        meta:
          $ref: '#/components/schemas/ResponseMeta'
      required:
        - success
        - data
        - meta
      example:
        success: true
        data:
          socialMediaUrls:
            facebook: https://www.facebook.com/handauncle
            instagram: https://www.instagram.com/handauncle
            linkedin: https://www.linkedin.com/company/handauncle
            twitter: https://twitter.com/handauncle
        meta:
          requestId: req_674e2f6c0e3d5f7g9b2c4d6e
          timestamp: '2025-12-10T14:34:52.123Z'
    SocialMediaUrlsData:
      type: object
      properties:
        socialMediaUrls:
          $ref: '#/components/schemas/SocialMediaUrls'
      required:
        - socialMediaUrls
      example:
        socialMediaUrls:
          facebook: https://www.facebook.com/handauncle
          instagram: https://www.instagram.com/handauncle
          linkedin: https://www.linkedin.com/company/handauncle
          twitter: https://twitter.com/handauncle
    ResponseMeta:
      type: object
      properties:
        timestamp:
          type: string
          format: date-time
        requestId:
          type: string
          description: Server generated correlation identifier.
      required:
        - timestamp
        - requestId
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
          enum:
            - false
        error:
          $ref: '#/components/schemas/ErrorObject'
        meta:
          $ref: '#/components/schemas/ResponseMeta'
      required:
        - success
        - error
        - meta
    SocialMediaUrls:
      type: object
      properties:
        facebook:
          type: string
          format: uri
        instagram:
          type: string
          format: uri
        linkedin:
          type: string
          format: uri
        twitter:
          type: string
          format: uri
      required:
        - facebook
        - instagram
        - linkedin
        - twitter
      example:
        facebook: https://www.facebook.com/handauncle
        instagram: https://www.instagram.com/handauncle
        linkedin: https://www.linkedin.com/company/handauncle
        twitter: https://twitter.com/handauncle
    ErrorObject:
      type: object
      properties:
        message:
          type: string
          description: Human-readable error message describing the issue.
          example: Please enter a valid 10-digit phone number (e.g., 9876543210)
        code:
          type: string
          description: Error code for programmatic handling.
          example: VALIDATION_ERROR
        details:
          type: array
          description: >-
            Array of field-specific validation errors (for VALIDATION_ERROR
            responses).
          items:
            type: object
            properties:
              field:
                type: string
                description: Field name that failed validation.
                example: phone
              message:
                type: string
                description: Specific validation error message for this field.
                example: Please enter a valid 10-digit phone number (e.g., 9876543210)
            required:
              - field
              - message
      required:
        - message
  responses:
    InternalError:
      description: Unexpected server error.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'

````