메인 콘텐츠로 건너뛰기
이 가이드는 리스트에 멤버를 추가하고 제거하는 과정을 단계별로 안내합니다.
사전 준비 사항시작하기 전에 다음이 필요합니다:
  • 승인이 완료된 App이 있는 개발자 계정
  • 사용자 액세스 토큰(OAuth 1.0a 또는 OAuth 2.0 PKCE)
  • 본인이 소유한 리스트

리스트에 멤버 추가하기

1

리스트 ID와 사용자 ID 가져오기

추가하려는 사용자의 ID와 대상 리스트의 ID가 필요합니다. user lookup endpoint를 사용해 사용자 ID를 확인할 수 있습니다.
2

멤버 추가하기

cURL
curl -X POST "https://api.x.com/2/lists/1441162269824405510/members" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"user_id": "2244994945"}'
3

응답 확인하기

{
  "data": {
    "is_member": true
  }
}

리스트에서 구성원 제거하기

cURL
curl -X DELETE "https://api.x.com/2/lists/1441162269824405510/members/2244994945" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"
응답:
{
  "data": {
    "is_member": false
  }
}

중요 사항

  • 본인이 소유한 리스트의 구성원만 관리할 수 있습니다
  • 사용자를 리스트에 추가할 때 해당 사용자의 동의는 필요하지 않습니다
  • 사용자는 자신이 추가된 공개 리스트를 확인할 수 있습니다

다음 단계

리스트 멤버 조회

리스트 멤버 조회

리스트 관리

리스트 생성 및 수정

API 참조 문서

전체 엔드포인트 문서